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•Prerequisites 
Major Topics: 



Five Days 

Personnel requiring analysis-level knowledge of 
Multics virtual memory implementation, metering and 
tuning. Especially useful for personnel concerned 
with maximizing system performance.. 

The Multics supervisor is logically divided into seven 
distinct subsystems. This course details the 
functions performed {and the data bases maintained) by 
five of these subsystems: Volume Management, Name and 
Address Space Management, Directory Control, Segment 
Control, and Page Control. Knowledge of the virtual 
memory implementation gives the student insight into 
the metering and tuning of the system. Other topics 
include overviews of the Multics system hardware, the 
Multics Supervisor, and a comparison with other memory 
management techniques. Question and answer periods 
are given daily to reinforce the material presented. 

Upon completion c: this course, the student should be 
able to: 

1. Understand the functions of the Multics supervisor 
subsystems, especially those subsystems which 
implement the Multics virtual memory. 

2. Make optimal design choices when writing system 
applications to run in the Multics environment. 

3. Evaluate and tune the system's performance by- 
analyzing the system's virtual memory meters. 

Multics Subsystem Programming (F15D), Source Level 
Debugging k The Process Environment (F21) or 
equivalent experience. 

System Hardware Components 
Volume (Disk) Management 
Name Space/Address Space Management 
Directory, Segment and Page Control 
Memory Management Techniques 
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Muitics Design Philosophy 
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MAJOR DESIGN GOALS 



s MULTIPLEXED INFORMATION AND COMPUTING SERVICE (MULTICS ) 



s MULTICS WAS ONE OF__THE FIRST OPERATING SYSTEMS • -TO BE THOROUGHLY 
DE SIGNED FROM _THE_ TOP DQWN~) THE DEVELOPERS: 



| STARTED WITH A SET OF GOALS 



0 CREATED A SYSTEM WHICH WOULD SATISFY THESE GOALS 



DEVELOPED GENERAL SOLUTIONS INSTEAD OF SPECIFIC SOLUTIONS 
(MAKING THE PRODUCT EXTENDABLE) - "- 



S PRODUCED A VIA3LE AND MARKETABLE PRODUCT 



Net To 3e Reoroaucec I-i FsCA 



MAJOR DESIGN GOALS 



THESE GOALS WERE CAREFULLY CHOSEN TO CHARACTERIZE A 'UTILITY-GRADE' 
COMPUTER SYSTEM, AND ARE OUTLINED BELOW : 



8 VIRTUAL MEMORY ORGANIZATION 



SELECTIVE , CONTROLLED SHARING 



SECURITY 



0 OPEN-ENDED , MODULAR SYSTEM 



jj DECENTRALIZED ADMINISTRATION 



" FLEXIBLE USER INTERFACES, END-USER ORIENTATION 



| CONTINUOUS OPERATION 



RELIABLE FILE SYSTEM 



2 REMOTE ACCESS 



EFFICIENT SERVICE TO LARGE AND SMALL USSR 



Not To 3e Reoroduced 1-2 FSOA 



VIRTUAL MEMORY ORGANIZATION 



B MOTIVATION 



n INFORMATION STORED ON-LINE IN LARGE INFORMATION UTILITIES OFTEN 
EXCEEDS THE SIZE OF AVAILABLE MAIN MEMORY - - 



[! THIS INFORMATION SHOULD BE DIRECTLY (AND CONTINUOUSLY) 
ACCESSIBLE BY THE USER COMMUNITY 



THE SIZE OF MAIN MEMORY SHOULD ONLY AFFECT PROCESSING TIMS, NOT 
PROCESSING CAPABILITY 



MAIN MEMORY MANAGEMENT SHOULD BE A TASK FOR THE - OPERATING 
SYSTEM, NOT THE PROGRAMMER - ------ 



8 IMPLEMENTATION 



2 ALL ON-LINE INFORMATION IS PROCESSOR ADDRESSABLE 



ALL INFORMATION (PROCEDURE AND DATA) IS COMPARTMENTALIZED INTO 
UNITS CALLED "SEGMENTS" ALLOWING THE ASSOCIATION OF ATTRIBUTES 
WITH EACH SEGMENT ( 1 ) 



(1) THROUGHOUT THIS DOCUMENT, GENERIC REFERENCES TO " SEGMENTS " INCLUDE 
DIRECTORIES AS WELL, SINCE DIRECTORIES ARE SIMPLY A SPECIAL KIND 
OF SEGMENT 

No: To 3e Reoroduced 1-3 FSOA 



VIRTUAL 



MEMORY ORGAN! 2 AT I ON 



0 SEGMENTS ARE MADE PROCESS ADDRESSABLE AS THEY ARE REFERENCED 



I ALL SEGMENTS ARE DIVIDED INTO AN INTEGRAL NUM3SR Or : 1024 WORD 
PAGES. THESE PAGES ARE BROUGHT INTO MAIN MEMORY I? AND ONLY I? 

- - THEY ARE REFERENCED (NEEDED) -AT THE TIMS THEY ARE REFERENCED -BY 
ANY PROCESS ------ 



THE MULTICS HARDWARE INTERPRETS ALL ADDRESSES AS OFFSETS WITHIN 
A SPECIFIED SEGMENT (SEGNO j OFFSET) 



THE HARDWARE MAKES NO DISTINCTION BETWEEN PROCEDURE AND DATA 
SEGMENTS . BOTH ARE PAGED IN THE SAMS MANNER, BOTH ARE ADDRESSED 
IN THE SAME MANNER 



S ALL COMPILERS PRODUCE LOAD MODULES - NO MODIFICATION IS REQUIRED 
TO EXECUTE PROCEDURE CODE 
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SELECTIVE , CONTROLLED SHARING 



B MOTIVATION 



USERS SHOULD 3E ABLE TO USE COMMON PROCEDURE AND DATA SEGMENTS 
DIRECTLY (NOT COPIES) 



USERS : SHOULD BE ABLE TO SHARE PRIVATE CODE IN A SELECTIVE MANNER 



8 IMPLEMENTATION 



PURE, REENTRANT CODE IS ALWAYS GENERATED BY- THE- COMPILERS 
(ALLOWING SHARING OF PROCEDURE CODE IN A MULTI -PROCESS 
SNVI RONMENT ) 



EVERYTHING THE USER TOUCHES (EXECUTE OR REFERENCE) WILL BE A 
SEGMENT HAVING ITS OWN ATTRIBUTES 



THE ACCESS ATTRIBUTES OF EACH SEGMENT ARE ESTABLISHED BY THE 
OWNER OF THAT SEGMENT 
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SECURITY 



E MOTIVATION 



IN AN ENVIRONMENT OF SEVERAL COEXISTING PROCESSES, USERS MUST BE 
PROTECTED FROM ACCIDENTALLY OR INTENTIONALLY INTERFERING- WITH 
EACH OTHER - - - 



THE SUPERVISOR MUST BE PROTECTED FROM DAMAGE BY USERS 



0 CHANGES IN ACCESS TO INFORMATION MUST 3S IMMEDIATELY EFFECTIVE 



DISCLOSURE OF INFORMATION SHOULD 3E ALLOWED IN A SELECTIVE AND 
CONTROLLED MANNER (VERSUS ALL-OR-NONS APPROACH) 



0 UNWARRANTED DENIAL OF ACCESS TO INFORMATION MUST BE PROHIBITED 



s I MPLEMENTATI ON 



Jj PER- SEGMENT ACCESS CONTROL LIST (ACL) - SPECIFYING BY WHOM AND 
HOW THE SEGMENT MAY BE ACCESSED 



RING PROTECTION MECHANISM - ISOLATES SEGMENTS AND PROCESSES 



H ACCESS ISOLATION MECHANISM (AIM) - ISOLATES SEGMENTS ACCORDING 
TO CATEGORIES AND SECURITY LEVELS 



PASSWORDS AND AUDIT TRAILS 
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SECURITY 




Reproduced 



1-7 



OPEN-ENDED, MODULAR SYSTEM 



s MOTIVATION 



SOFTWARE SHOULD EE EASY TO MODIFY AND EXTEND 



-f THE OPERATING SYSTEM SHOULD BE MODULAR , AND THE MODULES SHOULD 
BE COMPREHENSIBLE " :. 



E IMPLEMENTATION 



0 MODULAR DESIGN OF OPERATING SYSTEM AND USER PROGRAMS (COMPILERS, 
PROGRAMMING ENVIRONMENT ENCOURAGE MODULAR DESIGN")" 



I UNIFORM PROGRAMMING CONVENTIONS ARE FOLLOWED THROUGHOUT MOS' 



0 MORE THAN S2% OF THE OPERATING SYSTEM OBJECT CODE ORIGINATED 
'FROM PL/I SOURCE 



0 DYNAMIC LINKING (ELIMINATES RE-COMPILING, RE-EDITING WHEN 
UN-30UND MODULES ARE REPLACED) 



n ON-LINE MODIFICATION, TESTING AND INSTALLATION OF SYSTEM MODULES 
(MULTICS INSTALLATION FACILITY - MIS) 



I PATCH-FREE SYSTEM 



I LIBRARY MANAGEMENT TOOLS AND LIBRARY CONVENTIONS 



Not To Be Reproduced 
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D£ CENTRAL I 2 ED ADM I NX STRATI ON 



s MOTIVATION 



SYSTEM RESOURCES MUST BE EFFECTIVELY ADMINISTERED 



RESOURCE ALLOCATION, ACCOUNTING, REGISTRATION , - BILLING , ETC , IS 
TOO MUCH FOR SINGLE INDIVIDUAL 



DIFFERENT GROUPS OF USERS HAVE DIFFERENT ADMINISTRATIVE NEEDS 



s IMPLEMENTATION 



B GROUPING OF USERS, 3Y FUNCTION OR MANAGEMENT, INTO PROJECTS 



jj THREE-LEVEL HIERARCHY OF ADMINISTRATION 

D SYSTEM ADMINISTRATOR: DISTRIBUTES RESOURCES AND ASSIGNS 
ATTRIBUTES TO PROJECTS 



PROJECT ADMINISTRATORS: DISTRIBUTES RESOURCES AND ASSIGNS 
ATTRIBUTES TO USERS 



USERS: HAS FULL CONTROL OVER ALLOCATED RESOURCES , MODIFIED 
BY ASSIGNED ATTRIBUTES 



2 THE PROJECT ADMINISTRATOR MAY PASS DOWNWARD ONLY THOSE RESOURCES 
AND ATTRIBUTES THAT HAVE 3ESN GIVEN TO THE PROJECT 



Not To 3e Reproduced 
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PROCESS ATTRIBUTES 



ATTRIBUTES 

ASSIGNED 

TO 

PROJECT ABC 



ATTRIBUTES 

ASSIGNED 

TO 

PROJECT DEF 





INTERSECTION 
OF ATTRIBUTES 
(COMPUTED AT 
LOGIN TIME) 
GIVEN TO May's 
PROCESS 



ADDITIONAL DATA 
ABOUT May's 
PROCESS 



ATTRIBUTES 

ASSIGNED 

TO 

USER May 



ATTRIBUTES 

ASSIGNED 

TO 

USER Jones 



SYSTEM ADMINISTRATION TABLE 
(>sd >sat) 

CREATED AND MAINTAINED 
BY SYSTEM ADMINISTRATOR 



PROCESS INITIALIZATION TABLE 
([pd]>pit) 

ANSWERING SERVICE 
TABLE ENTRY 

(ANSWE RATABLE, 

ABSENTEE_USER_TABLE, 

DAEMON_USER_TABLE) 



PROJECT DEFINITION TABLE 
£>SC1>pdt>ABCpdt; 

CREATED AND MAINTAINED 
BY PROJECT ADMINISTRATOR 



CREATED AT LOGIN 
DESTROYED AT LOGOUT 
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FLEXIBLE USER INTERFACES 



8 MOTIVATION 



THE - - STANDARD USER ENVIRONMENT SHOULD 3E EXTENSIVELY 
USER-MODIFIABLE 



THE " "CAPABILITY SHOULD EXIST TO DEVELOP AND IMPOSE CLOSED 
SUBSYSTEMS WHICH CAN PROVIDE ANY DESIRED ENVIRONMENT 



a IMPLEMENTATION 



USER HAS ABILITY TO CHANGE OR REPLACE CONTROL PROGRAMS IN TH: 
USER'S RING 



PROJECT ADMINISTRATOR CAN IMPOSE A CLOSED SUBSYSTEM ENVIRONMENT 
OR A DIFFERENT orocess overseer ON USERS 



start_uo.ee, A3 3 REV PROCESSOR, aeneral ready, ready_o£f, 
add_sea~rch_rules, CONDITION HANDLING, " ETC. 



OTHER TOOLS PROVIDE SIMULATION, ENCAPSULATION CAPA3ILIT: 
(enter_lss, pro ject_start_up_J 



STANDARD INTERFACE FOR INTERACTIVE SUBSYSTEMS ( ssu_) ENCOURAGES 
UNIFORM, FAMILIAR BEHAVIOUR OF USER SUBSYSTEMS. 



Net To 3e Reproduced 
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CONTINUOUS OPERATION 



E MOTIVATION 



2 UTILITY CONCEPT: SYSTEM SHOULD BE AVAILA3LE ON DEMAND AT ALL 
TIMES 



s IMPLEMENTATION 



11 ON-LINE SOFTWARE INSTALLATION 

- jj- ON-LINE MAINTENANCE: MOVE MORE AND MORE BOS CAPABILITY INTO 
MULT I CS (EG: RE-BOCT FN? FROM MULTICS) 



£ ON-LINE FILE BACKUP AND RECOVERY 

| ON-LINE ACCOUNTING AND BILLING 

J DYNAMIC RECONFIGURATION 

I DYNAMIC FAILSOFT DSCONF I GURATI ON OF FAILING HARDWARE 

J UNATTENDED SERVICE 

J AUTOMATIC RE300T 
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RELIABLE FILE SYSTEM 



B MOTIVATION 



MUST PROVIDE USERS SOME ASSURANCE THAT THEIR ON-LINE INFORMATION 
IS SAFE 



MUST PROVIDE CHECKPOINT CAPABILITY FOR RECOVERY FROM USER ERROR 
OR SYSTEM DISASTER 



E IMPLEMENTATION 



jj AUTOMATIC 3ACKU? /RETRI EVAL FACILITY 



0 CONSOLIDATED STORAGE SYSTEM DUMPS 



0 PHYSICAL AND LOGICAL SAVE/RESTORE 



ALL STORAGE SYSTEM RECOVERY PROCEDURES RUN WHILE SYSTEM IS UP 



I DAMAGE RECOVERY RUN AUTOMATICALLY FOLLOWING SYSTEM FAILURE 
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REMOTE ACCESS 



s MOTIVATION 



B UTILITY CONCEPT: FULL ACCESS FROM ANY PHONE IN THE WORLD VIA 
ANY REMOTE DEVI CE 



WISH TO PROVIDE ONE " COMMAND LANGUAGE" , TO SERVE ALL USERS , 
WHETHER LOCAL OR REMOTE, INTERACTIVE OR BATCH 



B IMPLEMENTATION 



0 MULTICS COMMUNICATION SYSTEM (MCS) 

0 IN PRINCIPLE , ANY REMOTE DEVI CE/TERMI NAL IS C0NNECTA3LE 



1 SINGLE COMMAND LANGUAGE 

0 REMOTE JOB ENTRY (RJE) AND BULK I/O CAPABILITIES 

[I DIRECT ATTACHMENTS TO PUBLIC DATA NETWORKS VIA X.25 
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EFFICIENT SERVICE TO LARGE OR SMALL USERS 



S MOTIVATION 



UTILITY CONCEPT: SYSTEM SHOULD BE AVAILABLE FOR , - AND CAPA3L: 
OF, ANY SIZE TASK 



RUNNING BOTH LARGE AND SMALL TASKS TOGETHER SHOULD NOT IMPAC 
THE EFFICIENCY OF EITHER 



B IMPLEMENTATION 



|- DYNAMIC RESOURCE ALLOCATION (DON'T HAVE TO PRE- ALLOCATE ■ OR 
GUESS-TIMATE RESOURCES REQUIRED) 



0 SERVICE ON DEMAND 



J DYNAMIC SYSTEM TUNING TO ACCOMMODATE CHANGING SYSTEM WORKLOADS 
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STRUCTURE OF THE OPERATING SYSTEM 



| SUBROUTINES (550) 

| DESCRIBED IN THE MPM MANUALS "Multics Subroutines" (AG93) AND 
"Subsystems Writer's Guide" (OFTEN ABBREVIATED AS "SWG") 

(AK92) 



fl TOOLS (220) 

1 DESCRIBED IN THE MPM MANUAL "Multics Commands and Active 
Functions" (AG92) 

J ADMINISTRATIVE ROUTINES (200) 

0 DESCRIBED IN THE MAM MANUALS "System Administrator" (AK50), 
"Registration & Accounting Administrator" (AS68), "Project 
Administrator" (AK51 ) 



0 OPERATOR COMMANDS (150) 

B DESCRI3ED IN THE MANUAL "Operator's Handbook" (AM81) 
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WHAT IS THE MULTICS SUPERVISOR 



B WHAT IS THE MULTICS SUPERVISOR? 



| A COLLECTION OF MANY LOGICAL SUBSYSTEMS WHICH IMPLEMENT THE 
FUNCTIONS OF MULTICS 



0 THE PRIMARY PURPOSE OF MULTICS IS TO RUN PROGRAMS, WHICH ACCESS 
DATA, AND THUS THE MAJOR PURPOSE OF THE MULTICS SUPERVISOR IS TO 
MAKE THAT DATA ACCESSIBLE 

J THESE SUBSYSTEMS FALL INTO FOUR MAJOR GROUPS: 
1 THE FILE SYSTEM 

D SUPPORT SERVICES FOR THE FILE SYSTEM 
0 MISCELLANEOUS SUPERVISOR SERVICES 

0 SUBSYSTEMS RELATED TO, BUT NOT STRICTLY PART OF THE 
SUPERVI SOP. 



0 THESE DIVISIONS ARE SOMEWHAT ARTIFICIAL, 3ECAUSE THE SUBSYSTEMS 
ARE ALL INTIMATELY RELATED TO EACH OTHER. THE DIVISIONS 
REPRESENT A PARTICULAR VIEWPOINT OF SYSTEM FUNCTION. 



0 A MULTICS SUBSYSTEM IS A SET OF PROGRAMS PERFORMING A SPECIFIC 
SERVICE FOR THE USER COMMUNITY - AND FOR THE OPERATING SYSTEM 
ITSELF 

J - TOGETHER, ALL THESE SUBSYSTEMS IMPLEMENT THE FUNCTIONS DESCRIBED 
IN THE MPM SUBROUTINES AND SWG MANUALS, (ESSENTIALLY hcs_ AND 
THE VIRTUALS MEMORY). 



Not To Be Reproduced 
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THE MAJOR SUPERVISOR SUBSYSTEMS 



g MAJOR MULTICS SUPERVISOR SUBSYSTEMS: FOUR GROUPS OF ABOUT -FOUR 
SUBSYSTEMS EACH 



| THE FILE SYSTEM - THOSE SUBSYSTEMS WHICH ARE CONCERNED WITH 
STORING DATA, MANAGING DATA, AND MAKING IT AVAILABLE TO USERS . 
FIVE MAJOR COMPONENTS: 



| NAME SPACE / ADDRESS SPACE CONTROL 
| DIRECTORY CONTROL 
| VOLUME MANAGEMENT 

0 . SEGMENT CONTROL 

1 PAGE CONTROL 



SERVICES TO SUPPORT THE FILE SYSTEM, WHICH MULTIPLEX ITS 
FACILITIES BETWEEN DIFFERENT USERS , AND ENSURE ITS RELIABILITY. 
FOUR MAJOR COMPONENTS: 



| TRAFFIC CONTROL ■ 

| FAULT AND INTERRUPT HANDLING 

g SYSTEM INITIALIZATION 

8 THE FILE SYSTEM SALVAGERS 



Not To Be Reproduced 
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THE MAJOR SUPERVISOR SUBSYSTEMS 



8 MISCELLANEOUS SUPERVISOR SERVICES - THESE ARE THINGS DONE IN THE 
SUPERVISOR FOR REASONS OF ACCESS CONTROL AND SHARING, BUT NOT 
DIRECTLY RELATED TO THE FILE SYSTEM 

fl BECAUSE THEY ARE NOT DIRECTLY RELATED, THEY WILL NOT BE COVERED 
IN ANY DETAIL 

| MULTICS COMMUNICATIONS SYSTEM 

1 RESOURCE CONTROL 

1 USER DEVICE I/O - ioi_ 

| LOW LEVEL SUPERVISOR I/O 

8 RECONFIGURATION 

I SYSTEM ERROR HANDLING (syserr / verify_lock) 

0 RELATED SUBSYSTEMS - THESE ARE NOT ACTUALLY PART OF THE 
SUPERVISOR, BUT ARE CLOSELY RELATED 

0 METERING AND TUNING 

8 THE Initializer .SysDaemon 

a THE MULTICS SUPERVISOR IS DESIGNED AROUND THE _ "LAYERED MACHINE" 
CONCEPT 



Not To 3e Reproduced 
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THE MAJOR SUPERVISOR SUBSYSTEMS 



CONSTRUCT A SIMPLE SET OF OPERATIONS CALLED A "KERNEL" WHICH 
IMPLEMENTS THE MOST FUNDAMENTAL (PRIMITIVE) OPERATIONS REQUIRED 



CONSTRUCT A SLIGHTLY MORE SOPHISTICATED SET OF OPERATIONS WHICH 
ASSUMES AND RELIES ON THE CORRECT FUNCTIONING OF THE KERNEL - 
ANOTHER "LAYER" 



CONSTRUCT A MORE SOPHISTICATED LAYER WHICH ASSUMES AND RELIES ON 
THE CORRECT FUNCTIONING OF THE PREVIOUS MACHINES 



1 ETC 



THE "LAYERS" OF THE MULTICS SUPERVISOR PARTIALLY MAP INTO THE ABOVE 
SUBSYSTEMS 



THE FOLLOWING DIAGRAM REPRESENTS THIS MAPPING: 
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THE MAJOR SUPERVI SOR SUBSYSTEMS 




THE MULTICS SUPERVISOR 

COMPONENTS ARE ASYNCHRONOUSLY INVOKED 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 

s FUNCTION 

8 IMPLEMENT THE PER PROCESS VIRTUAL MEMORY 

2 BASIC PHILOSOPHY 

| AS A NEWLY LOGGED IN USER ATTEMPTS TO TOUCH VARIOUS SEGMENTS A 
CONSIDERABLE AMOUNT OF MANAGEMENT INFORMATION MUST BE 
(TRANSPARENTLY) FOUND AND/OR COMPUTED BEFORE THE USER'S 
REFERENCE IS ACTUALLY ACCOMPLISHED 

3 FOR EVERY SEGMENT REFERENCED BY THE USER, THE SUPERVISOR: 

1 ASSIGNS A SEGMENT NUMBER (FOR REASON OF HARDWARE ADDRESSING), 

* VTTl 

|j RECORDS (REMEMBERS) THE MANAGEMENT INFORMATION (FOR REASON OF 
SOFTWARE EFFICIENCY AND CONTROL) 

jj SUCH SEGMENTS ARE SAID TO BE "KNOWN TO THE PROCESS" 

1 THE MANAGEMENT INFORMATION IS MAINTAINED ON A PER PROCESS BASIS 
IN THREE COMPLEMENTING AREAS: DSEG , KST, AND RNT 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 



1 MANAGES TWO DISTINCT . SETS " OF INFORMATION: 



ADDRESS SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND 
THE SEGMENTS THEMSELVES 



NAME SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND NAMES 
THE USER REFERS TO THEM BY 



1 CALLS DIRECTORY CONTROL TO LOCATE SEGMENTS INITIALLY 



NAME SPACE / ADDRESS SPACE MANAGEMENT IS INVOKED BY SUBROUTINE 
CALLS, AND BY LINKAGE FAULTS (THE "DYNAMIC LINKER") 



B PRINCIPAL USER INTERFACES 



J COMMAND LEVEL 



initiate, terminate , terminate_segno, terminate_re£ _name , 
terminate_single_ref_name , list_ref_name 

THE COMMAND PROCESSOR ITSELF - WHICH USES THESE SERVICES TO 
LOCATE COMMANDS 



fl SUBROUTINE LEVEL 



hcs_$ini tiate , hcs_$ini tiate_count_ , hcs_$terminate_f iie , 
hcs_$terminate_seg7 hcs_$terminate_name , 
hcs~$terminate~noname , term_ 
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B MAJOR DATA BASES 

2 DESCRIPTOR SEGMENT (DSEG) - ONE PER PROCESS 

0 SEGMENT DESCRIPTOR WORD (SDW) - ONE PER KNOWN SEGMENT 
2 DEFINES THE USER'S ADDRESS SPACE TO THE HARDWARE 

2 KNOWN SEGMENT TABLE (KST) - ONE PER PROCESS 

1 KNOWN SEGMENT TABLE ENTRY (KSTE) - ONE PER KNOWN SEGMENT 
(EXCEPT SUPERVISOR SEGMENTS) 

2 DEFINES THE USER'S ADDRESS SPACE TO THE SUPERVISOR AND THE 
USER 

2 EACH KSTE ASSOCIATES A USER'S SEGMENT NUMBER WITH THE SEGMENT 
CONTROL ATTRIBUTES OF THAT SEGMENT 

2 THE SEARCH FOR AN AVAILABLE KSTE DETERMINES A SEGMENT'S 
NUMBER 

2 REFERENCE NAME TABLE (RNT) - ONE PER EACH RING IN EACH PROCESS 

2 NOT A SEGMENT - KEPT AS A REGION ALLOCATED IN THE "LINKAGE 
AREA" FOR EACH RING 

2 REFERENCE NAME TABLE ENTRY (RNTE) - ONE PER REFERENCE NAME 

2 USED BY THE DYNAMIC .LINKER TO IMPLEMENT THE 
"initiated^segments" SEARCH RULE 
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NAME SPACE /ADDRESS SPACE MANAGEMENT 



fl DEFINES THE USER'S NAME SPACE TO THE USER 



NAME SPACE MAY BE DIFFERENT IN DIFFERENT RINGS OF THE SAME 
PROCESS 
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DIRECTORY CONTROL 



B FUNCTION 



DIRECTORY CONTROL IS A SET OF HARDCORE MODULES RESPONSIBLE FOR 
THE .MAINTENANCE OF THE MCLTICS DIRECTORY STRUCTURE — IE ; THE 
HIERARCHY 



ITS TASKS INCLUDE CREATING, MANIPULATING AND INTERPRETING THE 
CONTENTS OF DIRECTORY SEGMENTS, TO INCLUDE: 



1 ACCESS CONTROL LISTS (ACL'S), NAMES, AND VTOCE POINTERS OF 
ENTRIES DESCRIBED THEREIN 



ONLY DIRECTORY CONTROL IS ALLOWED TO ALTER THE CONTENTS OF 
DIRECTORY SEGMENTS 



DIRECTORY CONTROL IMPLICITLY RELIES UPON THE SERVICES OF OTHER 
SUBSYSTEMS SUCH AS SEGMENT CONTROL AND PAGE CONTROL, AND ALSO 
INVOKES THEM DIRECTLY BY SUBROUTINE CALL 



DIRECTORIES ARE SIMPLY SEGMENTS TO THESE SUBSYSTEMS 



{j DIRECTORY CONTROL IS- INVOKED ONLY BY SUBROUTINE CALLS 



E PRINCIPAL USER INTERFACES 



| COMMAND LEVEL 
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DIRECTORY CONTROL 



Q create, create_dir, link, set_acl, delete_acl, status, list, 
add_name, rename 



fi SUBROUTINE LEVEL 

0 hcs_$append_branch, hcs_$add_acl_entr ies , hcs_$append_link , 
hcs_$delete_acl_entr iesT hcs_$status_, hcs_$chname_f ile 



8 MAJOR DATA BASES 



8 DIRECTORY SEGMENTS 

jj CONTAIN THE ATTRIBUTES AND OTHER INFORMATION ABOUT THEIR 
SEGMENTS (NEEDED TO FIND SEGMENTS, RETURN STATUS INFORMATION, 
AND BUILD VTOCE'S AT SEGMENT CREATION) 



3 THE DI RLOCKT_SEG 

8 SEGMENT WHERE DIRECTORY LOCKING IS MANAGED 
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VOLUME MANAGEMENT 



B FUNCTION 

jj VOLUME MANAGEMENT IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
AND LOGICAL VOLUMES 

J ITS TASKS INCLUDE: 

| ACCEPTANCE AND DEMOUNTING OF PHYSICAL VOLUMES 

1 MAINTAINING THE ASSOCIATION BETWEEN PHYSICAL VOLUMES, LOGICAL 
VOLUMES, AND DISK DRIVES 

| ENSURING THE INTEGRITY OF VOLUME CONTENTS 

8 MAKING VOLUME CONTENTS ACCES SABLE TO PAGE CONTROL (PAGES) AND 
SEGMENT CONTROL (VTOC ENTRIES) 

S VOLUME MANAGEMENT IS INVOKED ONLY BY SUBROUTINE CALLS 
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VOLUME MANAGEMENT 



B MAJOR DATA BASES 



|j PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 

| PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE KNOWN 
TO THE SYSTEM 



0 EACH PVTE IDENTIFIES A DRIVE'S DEVICE NUMBER, SUBSYSTEM NAME , 
DEVICE TYPE, AND INFORMATION ABOUT THE PHYSICAL VOLUME 
CURRENTLY MOUNTED 



1 USED TO MAP REFERENCES TO PAGES OF SEGMENTS. INTO" AN I/O 
REQUEST TO THE CORRECT DISK DRIVE " ' 



fl LOGICAL VOLUME TABLE (LVT) - ONE PER SYSTEM 

1 LOGICAL VOLUME TABLE ENTRY (LVTE) - ONE PER MOUNTED LOGICAL 
VOLUME 



0 EACH' LVTE CONTAINS THE LOGICAL VOLUME ID, POINTERS TO MEMBER 
PVTE'S, AIM CLASS LIMITS, ETC. 



fl USED TO DETERMINE A USER'S ACCESS TO A LOGICAL VOLUME 
( PRIVATE OR PUBLIC) AND TO LOCATE MEMBER PHYSICAL VOLUMES 



1' VOLUME HEADER - ONE PER PACK 

1 VOLUME LABEL (REGISTRATION AND ACCEPTANCE INFORMATION) 

| VOLUME MAP (OCCUPIED/VACANT INFORMATION FOR VOLUME CONTENTS 
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VOLUME MANAGEMENT 



2 RECORD STOCKS - ONE PER MOUNTED VOLUME 

0 ONLINE CACHE OF INFORMATION ABOUT USED / UNUSED RECORDS ON 
THE VOLUME 



0 THIS INFORMATION IS DERIVED FROM THE VOLUME MAP, BUT KEPT 
ONLINE TO AVOID THE NECESSITY OF REFERRING TO THE VOLUME MAP 
ON DISK EVERY TIME A RECORD IS ALLOCATED OR FREED 



| WHEN THE CACHE BECOMES COMPLETELY EMPTY OR COMPLETELY FULL, 
IT MUST BE UPDATED FROM/TO DISK - A PROTOCOL ENSURES THAT THE 
COPY ON DISK IS ALWAYS CONSISTENT 



1 PROVIDED BY VOLUME MANAGEMENT, BUT USED BY PAGE CONTROL 



B VTOCE STOCKS - ONE PER VOLUME 

1 SIMILAR TO RECORD STOCKS, BUT MAINTAINS INFORMATION ABOUT 
USED / UNUSED VTOC ENTRIES ON THE VOLUME 

n PROVIDED BY VOLUME MANAGEMENT, BUT USED BY SEGMENT CONTROL 



0 PHYSICAL VOLUME HOLD TABLE (PVHT) - ONE PER SYSTEM 

0 RECORDS THE COMMENCEMENT OF COMPOUND I/O OPERATIONS UPON A 
PHYSICAL VOLUME 



S THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE 
SUCH AN OPERATION IS IN PROGRESS 
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SEGMENT CONTROL 



B FUNCTION 



SEGMENT CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF LOGICAL 
MEMORY 



B ITS TASKS INCLUDE: 

fl MAINTAINING THE DISK RESIDENT MAPS OF SEGMENTS (IE: THEIR 
VTOCE'S) 

jj SEGMENT CREATION, TRUNCATION AND DELETION 

fl SEGMENT ACTIVATION AND DEACTIVATION (ASTE MULTIPLEXING) 



SEGMENT CONTROL CAN BE INVOKED ' EITHER BY SUBROUTINE CALLS OR BY 
SEGMENT FAULTS 



a BASIC PHILOSOPHY OF ACT I VAT I ON /DEACTI VATI ON 



1 OF ALL SEGMENTS RESIDENT WITHIN THE SYSTEM'S MOUNTED PHYSICAL 
VOLUMES, ONLY A SMALL SUBSET WILL REQUIRE ACCESSING AT ANY ONE 
TIME. SUCH SEGMENTS WILL BE CALLED "ACTIVE SEGMENTS" 



[j A PART OF MAIN MEMORY, CALLED THE "ACTIVE SEGMENT TABLE" (AST), 
WILL BE RESERVED TO HOLD MANAGEMENT INFORMATION FOR THESE ACTIVE 
SEGMENTS (IDENTITY, PVT INDEX, LOCATION OF PAGES., ETC.) 
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SEGMENT CONTROL 



AS SEGMENTS FALL INTO DISUSE, THEIR "MANAGEMENT INFORMATION" IN 
THE AST WILL BE REPLACED WITH INFORMATION OF OTHER SEGMENTS 
REQUIRING ACTIVATION 



b USER INTERFACE 

I COMMAND LEVEL 

| create, delete, truncate, etc. 



0 SUBROUTINE LEVEL 

| hcs_$append_branch , hcs_$append_branchx , hcs_$delentry_seg , 
hcs_$delentry_f ile , hcs_$truncate_seg , hcs_$truncate_f ile , 
hcs_$f orce_wr ite , etc 



S MAJOR DATA BASES 



SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM, SHARED WITH PAGE 
CONTROL. ONE MAJOR COMPONENT IS "OWNED" BY SEGMENT CONTROL: 



| ACTIVE SEGMENT TABLE (AST)' - ONE PER SYSTEM 

1 THE AST IS A LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 

0 ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 

fl ASTES CONTAIN PHYSICAL VOLUME ID'.S (PVID'S) AND VTOC 
INDEX'S (VTOCZ'S) OF SEGMENTS. NEEDED BY SEGMENT CONTROL 
TO FIND THE SEGMENT ON DISK (HARDWARE) 
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SEGMENT CONTROL 

| AST HASH TABLE 

0 ALLOWS EFFICIENT SEARCHING OF ASTE'S 

| LOGICALLY PART OF THE AST, BUT ELSEWHERE FOR HISTORICAL 
REASONS 

1 DIRECTORY SEGMENTS 

B CONTAIN LOCATIONS AND ATTRIBUTES OF SEGMENTS. LOCATION 
INFORMATION FROM DIRECTORY SEGMENTS IS PROVIDED TO SEGMENT 
CONTROL BY DIRECTORY CONTROL 

Q VOLUME TABLE OF CONTENTS (VTOC) - ONE PER PHYSICAL VOLUME 

1 VOLUME TABLE OF CONTENTS ENTRY (VTOCE) - ONE PER 
DISK-RESIDENT SEGMENT 

1 EACH VTOCE CONTAINS THE SEGMENT'S UNIQUE ID, CURRENT LENGTH, 
FILE MAP, ETC {NEED TO BUILD ASTE'S AND PT'S) 

B VTOCES ARE READ AND WRITTEN ONLY BY SEGMENT CONTROL 

fl VTOCE STOCKS - FROM VOLUME MANAGEMENT 

1 USED WHEN CREATING AND DELETING VTOCES FOR SEGMENTS 
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PAGE CONTROL 



B FUNCTION 



0 PAGE CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
MEMORY TO INCLUDE THE MULTIPLEXING OF MAIN MEMORY FRAMES, AND 
THE MANAGEMENT OF DISK STORAGE 



| ITS TASKS INCLUDE: 



TRANSFERRING THE PAGES OF SEGMENTS BETWEEN THE MEMORY 
DEVICES, AND RECORDING THE LOCATION OF "THE" COPY OF THESE 
PAGES 



REPORTING THE STATUS AND FILE MAPS OF SEGMENTS TO SEGMENT 
CONTROL 



PAGE CONTROL IS LARGELY CODED IN MULTICS ASSEMBLER LANGUAGE 
(ALM) 



PAGE CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
PAGE FAULTS 



THERE ARE NO EXPLICIT USER INTERFACES TO PAGE CONTROL 
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PAGE CONTROL 



B BASIC PHILOSOPHY 



| OF ALL THE SEGMENTS ACTIVE AT A GIVEN TIME, ONLY A SMALL SUBSET 
OF THEIR TOTAL PAGES WILL BE REQUIRED FOR ACCESSING 



0 PAGES WILL BE READ INTO MAIN MEMORY AS THEY ARE REQUIRED 



THE READING OF A PAGE INTO MAIN MEMORY WILL (PROBABLY-) REQUIRE 
THE EVICTION OF A PREVIOUSLY REQUIRED PAGE 



THE CHOICE OF A PAGE FOR EVICTION WILL BE BASED ESSENTIALLY UPON 
A "LEAST RECENTLY USED" CRITERIA 



AN EVICTED PAGE NEED 3E WRITTEN BACK TO DISK ONLY IF IT WAS 
MODIFIED DURING ITS RESIDENCY IN MAIN MEMORY 



a MAJOR DATA BASES 



PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM. PROVIDED 3" 
VOLUME MANAGEMENT 



| PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE 
CONFIGURED 



| EACH PVTE CONTAINS: 

fl THE DEVICE ID (DISK DRIVE ID) AND THE ID OF THE PHYSICAL 
VOLUME (DISK PACK) CURRENTLY MOUNTED 
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PAGE CONTROL 



J THE NUMBER OF RECORDS LEFT UNALLOCATED ON ' THE PHYSICAL 
VOLUME, POINTER TO THE RECORD STOCK, ETC 

| RECORD STOCKS - ONE PER MOUNTED PHYSICAL VOLUME, PROVIDED BY 
VOLUME MANAGEMENT 

D CONTAINS AN IN -MEMORY CACHE OF THE IN-USE STATUS OF RECORDS 
ON THE VOLUME, FROM THE VOLUME MAP, USED WHEN ALLOCATING OR 
FREEING PAGES 

0 ACCESSED BY A COMPLEX MECHANISM WHICH USES NORMAL PAGE I/O 
BUT HAS A PROTOCOL TO ENSURE SYNCHRONIZATION OF DISK CONTENTS 
AND RECORD STOCK CONTENTS 



J SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM. ' SHARED WITH 
SEGMENT CONTROL. CONTAINS THE FOLLOWING FIVE DATA BASES USED BY 
PAGE CONTROL: 



| SYSTEM SEGMENT TABLE (SST) HEADER - ONE PER SYSTEM 

1 CONTAINS A LARGE NUMBER OF COUNTERS AND POINTERS VITAL TO 
THE MAINTENANCE AND METERING OF THE STORAGE SYSTEM 

S CONTAINS LOCKWORDS USED TO SYNCHRONIZE PAGE CONTROL AND 
SEGMENT CONTROL OPERATIONS 



| CORE MAP - THE core_map SEGMENT - ONE PER SYSTEM 

0 CORE MAP ENTRY (CME) - ONE PER FRAME (1024 WORDS) OF 
CONFIGURED MAIN MEMORY 

| EACH CME REPRESENTS A FRAME OF MAIN MEMORY AND IDENTIFIES 
THE CURRENT OCCUPANT OF THAT FRAME 
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PAGE CONTROL 

NOT PART OF THE SST SEGMENT ANY MORE, BUT LOGICALLY PART 
OF THE SST 

ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 

0 ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 
| LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 

PAGE TABLES (PT) - ONE PER ACTIVE SEGMENT, THE OTHER HALF OF 
EACH ASTE 

1 PAGE TABLE WORD (PAGE PTW) - EITHER 4, 16, 64, OR 256 PER 
PAGE TABLE 

| EACH PTW DEFINES THE CURRENT LOCATION OF A PAGE OF THE 
SEGMENT: DISK, MAIN MEMORY ADDRESS, OR NULL 
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PAGE CONTROL 

THE MULTICS FILE SYSTEM 




STORAGE SYSTEM 



DISK DRIVES 
DISK PACKS 



MULTICS HIERARCHY 
LOGICAL VOLUMES 
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TRAFFIC CONTROL 



FUNCTION 



TRAFFIC CONTROL (OR THE "TRAFFIC CONTROLLER") IS RESPONSIBLE FOR 
MANAGING THE ASSIGNMENT OF PHYSICAL PROCESSORS TO MULTICS 
PROCESSES AND IMPLEMENTING THE SYSTEM'S WAIT/NOTIFY AND 
INTERPROCESS COMMUNICATION PRIMITIVES 



THE FUNCTIONS ASSUMED BY THE TRAFFIC CONTROLLER ARE KNOWN AS 
MULTIPROGRAMMING , MULTIPROCESSING , SCHEDULING , DI SPATCHING , 
PROCESSOR MANAGEMENT, AND INTERPROCESS COMMUNICATION. 



ITS MAJOR FUNCTION IS ALLOWING PROCESSES TO AWAIT THE COMPLETION 
OF FILE SYSTEM OPERATIONS, SUCH AS PAGE I/O 



| TRAFFIC CONTROL CAN BE INVOKED BY SUBROUTINE CALLS AND 
INTERRUPTS 



Q THERE ARE NO IMPORTANT USER SUBROUTINE INTERFACES, BUT THERE ARE 

PRIVILEGED SUBROUTINE INTERFACES FOR PROCESS CREATION. 
ADJUSTMENT OF SCHEDULING PARAMETERS, ETC. 



MAJOR DATA BASES 



TC__DATA SEGMENT - ONE PER SYSTEM. CONTAINS THE FOLLOWING FOUR 
DATA 3ASES: 



8 TCJDATA HEADER - ONE PER SYSTEM 

0 CONTAINS VARIOUS METERS, COUNTERS AND POINTERS USED 3Y THE 
TRAFFIC CONTROLLER 
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TRAFFIC CONTROL 



1 ACTIVE PROCESS TABLE (APT) - ONE PER SYSTEM 

I ACTIVE PROCESS TABLE ENTRY (APTE) - ONE OCCUPIED PER 
ACTIVE PROCESS (TOTAL NUMBER IS DETERMINED BY CONFIG DECK) 

| EACH APTE CONTAINS VARIOUS ATTRIBUTES OF AN ACTIVE PROCESS 
INCLUDING THE PROCESS ID, STATE, THE VALUE OF ITS 
DESCRIPTOR BASE REGISTER (DBR) , SCHEDULING PARAMETERS, AND 
A POINTER TO THE PROCESS'S ITT ENTRIES 

D THE APTE CONTAINS ALL INFORMATION THE SUPERVISOR NEEDS TO 
KNOW ABOUT A PROCESS WHEN THE PROCESS IS NOT RUNNING 



8 INTERPROCESS TRANSMISSION TABLE (ITT) - ONE PER SYSTEM 

A ITT ENTRY - ONE OCCUPIED PER OUTSTANDING IPC WAKEUP 

0 A QUEUE FOR TEMPORARILY STORING IPC WAKEUP INFORMATION 
(CHANNEL NAME, RANDOM DATA, PROCESS ID, ETC) 



1 WORK CLASS TABLE (WCT) ~ ONE PER SYSTEM 

8 WORK CLASS TABLE ENTRY (WCTE) - ONE PER WORKCLASS 

1 EACH WCTE CONTAINS ADMINISTRATOR DEFINED PARAMETERS OF THE 
WORKCLASS, VARIOUS METERS AND POINTERS 
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FAULT AND INTERRUPT HANDLING 



8 FUNCTION 



| RESPONSIBLE FOR HANDLING ALL EXCEPTIONS IN A CPU WHETHER 
INTERNAL TO THE PROCESSOR (REFERRED TO AS FAULTS ) OR EXTERNAL 
(REFERRED TO AS INTERRUPTS ) 

| ESTABLISHES THE SUPERVISOR ENVIRONMENT AT FAULT AND INTERRUPT 
TIME. SAVES THE MACHINE CONDITIONS AND TRANSFERS TO THE 
APPROPRIATE HANDLER 



1 MAJOR COMPONENTS: THE FAULT INTERCEPT MODULE (fim), WX RED-FAULT 
INTERCEPT MODULE (wired_f im) , I/O INTERRUPT HANDLER 
( io_interrupt ) , sys_trouble , page_fault 



s MAJOR DATA BASES 



jj INTERRUPT VECTORS - ONE SET PER SYSTEM (WIRED) 

D INTERRUPT PAIR (2 INSTRUCTIONS) ~ ONE PAIR PER DEFINED 
INTERRUPT TYPE 

| LOCATED AT ABSOLUTE ADDRESS 0. A HARDWARE RECOGNIZED DATA 
BASE 

| DESCRIBE WHERE TO SAVE THE CONTEXT , AND WHERE TO TRANSFER TO 
TO PROCESS THE INTERRUPT (ALWAYS io_interrupt ) 
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FAULT AND INTERRUPT HANDLING 



0 FAULT VECTORS - ONE SET PER SYSTEM (WIRED) .. 

0 VECTOR PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED FAULT 
TYPE 



J LOCATED AT ABSOLUTE ADDRESS 100 (OCTAL) IMMEDIATELY ABOVE THE 
INTERRUPT VECTORS. A HARDWARE RECOGNIZED DATA BASE 



S DESCRIBE WHERE TO SAVE THE CONTEXT , AND WHERE TO TRANSFER TO 
TO PROCESS THE FAULT (fim, wired_fim, page_fault) 



PROCESS DATA SEGMENT (PDS) - ONE PER PROCESS J WIRED WHEN 
ELIGIBLE) 



0 CONTAINS PROCESS RELEVANT INFO SUCH AS PROCESS ID, USER ID, 
HOME/WORKING/PROCESS DIRECTORIES, AIM CLASSIFICATION, INITIAL 
RING, ETC 



CONTAINS ALL INFORMATION ABOUT tHE PROCESS NEEDED BY THE 
SUPERVISOR CODE WHEN THE PROCESS IS RUNNING 



CONTAINS SAVE AREAS FOR CONTEXT INFORMATION . ABOUT FAULTS 
WHICH CAN RESULT IN GIVING UP THE PROCESSOR: PAGE FAULTS, 
SEGMENT FAULTS, AND ALL FAULTS NOT HANDLED BY THE SUPERVISOR 



jj PROCESSOR DATA SEGMENT (PRDS) - ONE PER CONFIGURED CPU (WIRED) 

jj SERVES AS RING-ZERO STACK FOR PAGE CONTROL AND TRAFFIC 
CONTROL 



fi ALSO CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH USUALLY DO NOT MEAN GIVING UP THE PROCESSOR: CONNECT 
FAULTS AND INTERRUPTS. 
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8 F I MJTABLE 



FAULT AND INTERRUPT HANDLING 



0 A TABLE IN THE FIM PROGRAM WHICH DESCRIBES THE ACTION TO BE 
TAKEN FOR VARIOUS TYPES OF FAULTS 



32 



i£ T gffi^ /toe. 



lit VMui N fe**ter 




( OCT. 




5 y»w°K r, t >, 



5/^ 



Not To Be Reproduced 



2-29 



F80A 



SYSTEM . INITIALIZATI ON 



B FUNCTION 



1 PREPARE THE SYSTEM TO OPERATE, ' STARTING FROM A COMPLETELY EMPTY 



2 READS IN SUPERVISOR PROGRAMS FROM SYSTEM TAPE, SNAPS LINKS 
BETWEEN SUPERVISOR COMPONENTS, VERIFIES AND INITIALIZES HARDWARE 
CONFIGURATION, SETS UP SYSTEM DATABASES, ACCEPTS STORAGE SYSTEM 
DISKS AND PREPARES THEM FOR USE BY THE FILE SYSTEM 



. -1-MOST -PROGRAMS IN SYSTEM INITIALIZATION ARE DELETED AFTER 
INITIALIZATION IS COMPLETE . <^!y -re)tj j Pc 7i^ i £ ICofT. 



2 SUPERVISOR PROGRAMS ARE LOADED IN THREE "COLLECTIONS", EACH OF 
WHICH DEPENDS ON THE MECHANISMS SET UP BY THE PREVIOUS ONE . 



s MAJOR DATA BASES 



0 THESE DATA BASES ARE ALL BUILT DURING THE PROCESS OF 
INITIALIZATION (EXCEPT FOR THE CONFIG DECK) AND KEPT AFTER 
INITIALIZATION IS FINISHED fe?r ^e^o^, 



S SEGMENT LOADING TABLE (>sll>slt) 

fl CONTAINS AN ENTRY DESCRIBING THE ATTRIBUTES OF EACH SEGMENT 
IN THE SUPERVISOR 



MACHINE 





Not To Be Reproduced 



.2-30 



F80A 



SYSTEM INITIALIZATION 




| NAME TABLE ( >sll>name_table ) 

| CONTAINS A LIST OF NAMES FOR EACH OF THE SEGMENTS IN THE 
SUPERVI SOR 



J DEFINITIONS SEGMENT ( >sll>def initions_) 



| CONTAINS THE DEFINITIONS SECTIONS FOR ALL THE -SEGMENTS IN THE 
SUPERVISOR, WHICH ARE USED IN ORDER TO SNAP LINKS BETWEEN THE 
SUPERVISOR MODULES 



0 CONFIG DECK ( >sll>conf ig_deck ) 



0 CONTAINS A DESCRIPTION OF THE HARDWARE CONFIGURATION AND 
CERTAIN SOFTWARE PARAMETERS 



| PROVIDED TO SYSTEM INITIALIZATION BY BOS 



a SHUTDOWN — TERMINATES THE ACTIVITIES OF THE SYSTEM IN AN ORDERLY 
FASHION 



| TWO TYPES OF SHUTDOWN: 



A NORMAL — REQUESTED BY THE INITIALIZER, RUNS IN THE USUAL 
SUPERVISOR ENVIRONMENT 



R EMERGENCY — USED AFTER A CRASH, MUST MAKE THE SUPERVISOR 
ENVIRONMENT OPERABLE BEFORE PROCEEDING 
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SYSTEM INITIALIZATION 



BOTH TYPES EXIST PRIMARILY TO SHUT DOWN THE FILE SYSTEM — THAT 
IS, TO WRITE ALL DATA IN MEMORY INTO ITS PROPER HOME ON DISK 



S INCLUDES PAGES OF SEGMENTS, VTOCES , VOLUME AND VTOC MAPS 



1 SHUTDOWN ESSENTIALLY RUNS THE ' STEPS OF INITIALIZATION BACKWARDS, 
BUT WITH A LOT OF SHORTCUTS 
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FILE SYSTEM SALVAGERS 



8 FUNCTION 



fl ENSURE THE CONSISTENCY OF THE FILE SYSTEM DATABASES AND PERFORM 
PERIODIC PREVENTIVE MAINTENANCE OPERATIONS 

| THERE ARE SEVERAL SALVAGERS, EACH WITH A DIFFERENT FUNCTION 

1 BECAUSE OF THE COMPLICATED INTERACTIONS THEY HAVE WITH THE REST 
OF THE FILE SYSTEM, THE SALVAGERS ARE PERHAPS THE MOST 
COMPLICATED SINGLE PROGRAMS IN THE SUPERVISOR 



J SOME SALVAGING IS DONE AUTOMATICALLY, WHEN THE SYSTEM DETECTS AN 
INCONSISTENCY. OTHER SALVAGE OPERATIONS ARE EXPLICITLY 
REQUESTED, BY PRIVILEGED USERS. 

1 EXCEPT FOR SUPERVISOR BUGS, THE ONLY TIME DAMAGE OCCURS THAT 
REQUIRES SALVAGING TO FIX IS AFTER A CRASH WHERE EMERGENCY 
SHUTDOWN FAILS 



s THE SALVAGERS: 



0 DIRECTORY SALVAGER 

0 CORRECTS INCONSISTENCIES IN DIRECTORY SEGMENTS 3Y REBUILDING 
THEM 

fl THIS IS THE ONLY SALVAGER INVOKED AUTOMATICALLY IN USER 

PROCESSES: ANY ATTEMPT TO LEAVE RING ZERO WITH A DIRECTORY 

LOCKED FOR WRITING WILL CAUSE IT TO BE SALVAGED 
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FILE SYSTEM SALVAGERS 



1 DIRECTORY SALVAGING ALSO RECLAIMS WASTED SPACE IN THE 

DIRECTORY, AND IS RUN PERIODICALLY TO COMPACT DIRECTORIES 

1 QUOTA SALVAGER 

| CORRECTS INCONSISTENCIES IN THE QUOTA SYSTEM 



I RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION .FROM THE 
VTOCES ON A VOLUME, THEREBY RECLAIMING ANY RECORDS OR VTOCES 
WHICH MIGHT HAVE BEEN LOST 



I THIS TYPE OF__DAMAGE__IS USUALLY BENIGN, SO RUNNING THE 
SCAVENGER CAN BE DELAYED. 



fl 'PHYSICAL VOLUME SALVAGER 



0 RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION 



0 RUNS ONLY DURING INITIALIZATION, AND THEREFORE DELAYS CRASH 
RECOVERY 



0 NOW USED ONLY FOR RARE CASES WHERE THERE IS NOT ENOUGH FREE 
SPACE LEFT FOR THE SCAVENGER TO RUN. IN THESE RARE CASES, IT 
IS INVOKED AUTOMATICALLY BY SYSTEM INITIALIZATION. 



0 PHYSICAL VOLUME SCAVENGER 




| RUNS ENTIRELY ONLINE WHILE THE SYSTEM IS UP FOR USERS (NEW IN 
MR10.1) 



0 SWEE?_PV 
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FILE SYSTEM SALVAGERS 



fl DELETES UNUSED VTOC ENTRIES WHICH HAVE 'NO DIRECTORY ENTRY 
POINTING TO THEM 

0 RUNS ENTIRELY IN USER RING, EXCEPT FOR ACTUALLY READING VTOC 
ENTRIES AND DIRECTORY ENTRIES 

Q PURELY A HOUSEKEEPING FUNCTION, AND RUN ONLY RARELY. 
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METERING & 



TUNING 



WHILE NOT A SUBSYSTEM ITSELF , METERING AND TUNING IS A POLICY AND 
CAPABILITY COMMON TO ALL OF THE SUPERVISOR'S SUBSYSTEMS 



£ FUNCTION 



1 METERING (CONSISTS OF THREE ACTIVITIES) 



S ACCUMULATING DATA: THIS IS PERFORMED THROUGHOUT THE 
SUPERVISOR BY CODE WHICH 

1 RECORDS THE NUMBER OF TIMES AN EVENT HAPPENS OR A 
PARTICULAR PIECE OF CODE IS EXECUTED; AND/OR 

2 RECORDS' THE TIME REQUIRED TO PERFORM A TASK 

0 SUCH' DATA IS STORED IN AREAS REFERRED TO AS "METERING 
C&iLliS ** 



J EXTRACTING DATA: THIS IS PERFORMED BY NUMEROUS METERING 
COMMANDS WHICH (WHEN INVOKED) 

5 READ AND STORE THE CURRENT VALUES OF RELEVANT METERING 
CELLS 



J REPORTING THE DATA: THIS IS PERFORMED BY THE METER COMMANDS 
WHICH (WHEN INVOKED) 

| COMPARE CURRENT METERING CELL VALUES WITH PREVIOUSLY READ 
VALUES 

S PERFORM THE APPROPRIATE ARITHMETIC COMPUTATIONS UPON THE 
DATA IN ORDER TO ARRIVE AT THE DESIRED STATISTIC 

II ARRANGE THE DATA IN A USEFUL FORMAT (A REPORT OR DIAGRAM) 
AND PRINT IT 
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METERING & TUNING 



| TUNING 



CHANGING THE SYSTEM'S OPERATING PARAMETERS AND /OR 
CONFIGURATION BASED UPON THE DATA AND INSIGHTS FROM THE 
SYSTEM'S METERS 



B MAJOR DATA BASES 



fl SST HEADER , TCJDATA HEADER f ETC, 
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I NI TI ALI 2SR . SYSDAEMON 

FUNCTION 

0 THE SYSTEM'S INITIALIZATION, ADMINISTRATIVE AND CONTROL PROCESS 
(Initializer . SysDaemon .2 ) , RESPONSIBLE FOR: 

I INITIALIZING THE OPERATING SYSTEM AT BOOTLOAD, FOLLOWING 
SUCCESSFUL INITIALIZATION OF THE SUPERVISOR 

I ANSWERING SERVICE (login and logout) 

S PROCESS CREATION AND DESTRUCTION 

0 MESSAGE COORDINATOR (DAEMON COORDINATION) 

S SYSTEM ADMINISTRATION .FUNCTIONS 

0 SYSTEM ACCOUNTING FUNCTIONS 

MAJOR DATA BASES, ALL KEPT' IN >scl 

1 ANSWERJTABLE 

0 AB S ENTEE__US ER_T ABLE 

1 DAEMON_USER_TABLE 
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I NITIALI ZER . SYSDASMON 



1 MASTER GROUP TABLE (MGT) 

1 CHANNEL DEFINITION TABLE (CDT) 

1 SYSTEM ADMINISTRATION TABLE (SAT) 

Q PERSON NAME TABLE (PNT) 

jj PROJECT DEFINITION TABLES (PDT'S) 
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WHAT IS A PROCESS 



B A MULTICS PROCESS IS A WELL DEFINED COLLECTION OF SEGMENTS, EACH 
WITH DEFINED ACCESS, OVER WHICH A SINGLE EXECUTION POINT IS FREE TO 
ROAM (I.E. , FETCH INSTRUCTIONS AND MAKE DATA REFERENCES) 



THE ADDRESS SPACE OF A PROCESS IS THE ABOVE "COLLECTION OF 
SEGMENTS". SUCH SEGMENTS ARE SAID TO BE KNOWN TO THE PROCESS 



a EVERY LOGGED IN USER HAS A PROCESS 



B VERY IMPORTANT CONCEPT: THE MULTICS SUPERVISOR RUNS IN THE USER ' S 
PROCESS (IE: IN THE USER'S ADDRESS SPACE), BUT IN A DIFFERENT RING 



B A PROCESS TAKES ON THE IDENTITY OF THE SOFTWARE IT IS EXECUTING 
WHERE EVER IT GOES 



| WHEN A USER WISHES TO CREATE A SEGMENT, IT IS THE USER'S PROCESS 
WHICH EXECUTES THE SUPERVISOR CODE hcs_$apDend, CREATING THE 
SEGMENT 



fi A PROCESS CAN BE VIEWED AS A CONTINUAL FLOW OF EXECUTION 
FLUCTUATING BETWEEN DIFFERENT RINGS: PRIMARILY RING FOUR AND RING 
ZERO 
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WHAT IS A PROCESS 



2 



PROCESS FLOW OF EXECUTION 



TIME 



ALL PROCEDURE CODE (WHETHER SUPERVISOR OR USER CODE) MUST HAVE A 
STACK FRAME CONTAINING ITS ARGUMENTS AND ENVIRONMENT DATA 



FOR REASONS OF SECURITY, MULTICS REQUIRES ONE STACK PER RING OF 
EXECUTION. WHEN EXECUTING RING "N" PROCEDURES, THERE WILL EXIST A 
RING "N" STACK CONTAINING STACK FRAMES FOR THESE PROCEDURES 
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STACK PER RING 



PR6 



PR7 



FRAME 2 



FRAME 1 



STACK 
HEADER 



nj 

GO 



fault 



5p<\ -# 230stack_0 
J (0.0,0) 

SEVERAL (10 30) 
PER SYSTEM, SHARED 



FRAME 3 



FRAME 2 



FRAME 1 



STACK 
HEADER 




4t 231 stack_1 
(1,1.1) 
IN USER'S PROCESS 
DIRECTORY 



FRAME 5 



FRAME 4 



FRAME 3 



FRAME 2 



FRAME 1 



STACK 
HEADER 



#- 234 stack_4 
(4,4,4) 

IN USER'S PROCESS 
DIRECTORY 



* PR7 IS THE STACK BASE POINTER REGISTER. POINTS TO CURRENT STACK. HARDWARE LOADED WITH 
DBR.stack *8 + RING. THE VALUE OF DBR .stack CAN CHANGE WITH EACH RELEASE. IT IS 23 IN MR 10.1. 

} 

* PR6 IS THE STACK FRAME POINTER REGISTER. POINTS TO CURRENT STACK FRAME. 



COOPERATING PROCESSES 



B ALL ACTIVE PROCESSES ( INTERACTIVE , ABSENTEE, AND DAEMONS) APPEAR TO 
BE AUTONOMOUS AND INDEPENDENT OF ONE ANOTHER 



B IN REALITY , ALL PROCESSES ARE CONTINUALLY COOPERATING, COMPETING 
AND SHARING 



| EXAMPLES OF COOPERATION 

0 VOLUNTARY 

8 THE SENDING AND ACCEPTING OF MESSAGES AND MAIL 

D PREPLANNED BY SYSTEM PROGRAMMERS 

g EVERY PROCESS, BEFORE RELINQUISHING A PROCESSOR, CHOOSES 
THE MOST DESERVING REPLACEMENT AND EXECUTES THE CODE- WHICH 
DISPATCHES THE CHOSEN PROCESS 

J EVERY PROCESS, WHEN RUNNING , WILL SERVICE ALL INTERRUPTS 
FIELDED BY ITS PROCESSOR. THESE INTERRUPTS ARE GENERALLY 
THE REPLIES TO THE REQUESTS OF OTHER PROCESSES (IE: THE 
ARRIVAL OF A PAGE REQUESTED SOME TIME EARLIER) 

1 PREPLANNED BY APPLICATION PROGRAMMERS 

D THE MULTICS TRANSACTION PROCESSOR IS COMPOSED OF MANY 
COOPERATING, INTER-DEPENDENT PROCESSES 



fl EXAMPLES OF COMPETITION 



2 ALL PROCESSES COMPETE FOR PROCESSOR TIME AND MAIN MEMORY 
RESOURCES 
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COOPERATING PROCESSES 



THIS COMPETITION IS HIGHLY REGULATED IN ORDER FOR ALL 
PROCESSES TO BE TREATED FAIRLY 



fl THE COMPETITION IS ALSO SUBJECT TO VERSATILE ADMINISTRATIVE 
CONTROLS 



EXAMPLES OF SHARING 



| BY DESIGN, A SIGNIFICANT PART OF THE ADDRESS SPACE OF ALL 
PROCESSES IS IDENTICAL (THE SUPERVISOR SEGMENTS) 

S BY DEFAULT, REFERENCES TO SEGMENT foo BY TWO DIFFERENT 
PROCESSES WILL RESULT IN REFERENCES TO THE SAME SEGMENT 
(LOGICALLY, PHYSICALLY, ACTUALLY AND ABSOLUTELY) 



THERE IS NO SEPARATE ENTITY IN MULTICS LIKE AN EXECUTIVE DOING 
THINGS ON BEHALF OF THE USER. THE Initializer . SysDaemon IS NOT THE 
TIME-SHARE EXECUTIVE OF MULTICS 
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THE PL/I OPERATORS 



B OPERATORS ARE LANGUAGE DEPENDENT PIECES OF CODE WHICH IMPLEMENT 
HARDWARE OR OPERATING- SYSTEM DEPENDENT FUNCTIONS SUCH AS CALLING 
AND SIGNALLING 



B CURRENTLY THERE ARE OPERATORS FOR PL/I, COBOL, AND BASIC. ALM AND 
FORTRAN SHARE THE PL/I OPERATORS 



B ALL OPERATORS IN MULTICS ARE PURE , SHARED AND RE-ENTRANT ALM CODE 



B OPERATORS COULD BE GENERATED BY THE COMPILERS AND PLACED IN LINE 
WITH OTHER CODE, HOWEVER, THERE ARE DISADVANTAGES: 



SOME OPERATORS ARE TOO BULKY TO BE INCLUDED WITH EACH USE (SUCH 
AS COMPLICATED I/O STATEMENTS) 



SOME OPERATORS MIGHT CHANGE IN THE FUTURE (SUCH AS ENTRY AND 
RETURN SEQUENCES) 



OPERATORS ARE SIMILAR TO QUICK INTERNAL PROCEDURES IMPLEMENTING 
WHAT IS OFTEN CALLED "LIBRARY FUNCTIONS" IN OTHER OPERATING SYSTEMS 
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THE PL/I OPERATORS 



B INSTEAD OF PASSING ARGUMENT LIST, ARGUMENTS ARE USUALLY PASSED TO 
THE OPERATORS IN THE CPU'S REGISTERS 



INSTEAD OF BEING CALLED BY A PROCEDURE CALL, A SINGLE TRANSFER 
INSTRUCTION IS USED (tSxO or tsp3) 



THE PL/I OPERATORS IMPLEMENT THE SUPPORT FUNCTIONS FOR THE PL/I 
ENVI RONMENT 



SINCE A MULTICS PROCESS IS A PL/I ENVIRONMENT, THE PL/I OPERATORS 
ARE VITAL TO THE MULTICS SUPERVISOR (AND ANY OTHER PROGRAMS WRITTEN 
IN PL/I) 
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INTERFACES TO SYSTEM MODULES 



B UNLIKE OTHER SUPERVISORS, THE MULTICS SUPERVISOR IS NOT SEQUENTIAL 
- THAT IS, THE CONCEPT OF "JOB FLOW" DOES NOT REALLY APPLY 



0 INSTEAD, THE SUBSYSTEMS PERFORM ASYNCHRONOUSLY, BEING 'INVOKED' 
BY THOSE PROCESSES WHO REQUIRE THEIR SERVICES 



J THESE SUBSYSTEMS ARE INVOKED BY THE USER'S PROCESS IN ONE OF 
THREE WAYS: ■ 



B EXPLICITLY - VIA A SUBROUTINE CALL OR A COMMAND 

| IMPLICITLY - VIA A FAULT v , i 

"OtfT ^yV^^U 5o wc\ 5>/^*0°- oversew. 

1 IMPLICITLY - VIA AN INTERRUPT 




INTERRUPT SIDE 



CALL SIDE: SERVICES PERFORMED AS A RESULT OF EXPLICIT 

SUBROUTINE CALLS. LOCKS ARE NORMALLY 
WAIT LOCKS. 

FAULT SIDE: SERVICES PERFORMED AS A RESULT OF FAULTS. 
LOCKS ARE NORMALLY WAIT LOCKS. 

INTERRUPT SIDE: SERVICE PERFORMED AS A RESULT OF INTERRUPTS. 
LOCKS ARE LOOP LOCKS. 



Not To 3e Reproduced 



3-9 



F80A 



DEADLOCK PREVENTION 



WHAT IS DEADLOCK? 



| DEADLOCK CAN OCCUR IN ANY MULTI -PROGRAMMING ENVIRONMENT WHEN TWO 
OR MORE PROCESSES COMPETE RANDOMLY FOR SERIALLY REUSABLE 
RESOURCES 



S THE CLASSIC EXAMPLE OF DEADLOCK IS THE "DEADLY EMBRACE" 




DEADLY EMBRACE 

• PROCESS A IS WAITING FOR A RESOURCE OWNED BY PROCESS B. 

• PROCESS B IS WAITING FOR A RESOURCE OWNED BY PROCESS A. 
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DEADLOCK PREVENTION 



DEADLOCK SOLUTIONS 



1 DETECTION AND UNLOCKING 



SOME SYSTEMS EMPLOY " SCHEMES WHICH DETECT THE OCCURRENCE OF 
DEADLOCK AND "UNTANGLE" THE INVOLVED PROCESSES 



DETECTION SCHEMES ARE USUALLY DIFFICULT TO IMPLEMENT AND 
EXPENSIVE IN TERMS OF OVERHEAD 



THE ACT OF UNTANGLING THE INVOLVED PROCESSES USUALLY RESULTS 
IN AT LEAST ONE OF THEM LOSING RESOURCES , PRIORITY, OR EVEN 
ITS LIFE 



0 PREVENTION 



MOST SYSTEMS ADOPT SOME FORM OF PREVENTION INSTEAD OF 
DETECTION 



t » w urn fwrm rvn mr.Tr\ o^\T">we* 



[J CHECKING: WHEREBY REQUESTS FOR RESOURCES ARE SCREENED FOR 
DEADLOCK POTENTIAL PRIOR TO ACCEPTANCE 

H IMPOSED POLICY: WHEREBY REQUESTS FOR MORE THAN ONE 
RESOURCE MUST BE MADE: 

0 TOGETHER AS ONE TOTAL REQUEST BEFORE THE "JOB" OR 
"JOB-STEP" COMMENCES (ALL OR NOTHING); OR 

0 SERIALLY , IN A FIXED , PRE-DEFINED ORDER 
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a MULTICS, IN GENERAL , ADOPTS THE FOLLOWING DEADLOCK PREVENTION 
SCHEME: 



g USER ASSIGNABLE RESOURCES (SUCH AS TAPE DRIVES , CARD PUNCHES, 
ETC ) 



1 WHEN THE USSR IS INTERACTIVE NO POLICY IS ENFORCED. THE USER 
IS INFORMED IF THE RESOURCE IS BUSY AND MAY EITHER TRY AGAIN 
OR GIVE UP 



1 WHEN THE USER IS NOT INTERACTIVE, THE "ALL" OR "NONE" 

APPROACH SHOULD. BE USED. THE AVAILABILITY OF ALL REQUIRED 

RESOURCES BECOMES THE DETERMINING FACTOR IN SCHEDULING THE 

USER { SEE THE "RESOURCE CONTROL PACKAGE") 



S SHOULD A NON- INTERACTIVE USER ATTEMPT SERIAL REQUESTS FOR 
RESOURCES, A DEADLOCK SITUATION COULD POTENTIALLY ARISE AND 
EXIST UNTIL THE AUTOMATIC LOGOUT DUE TO INACTIVITY OCCURS 



8 USER ACCESSIBLE RESOURCES (SUCH AS FILES, DATA BASES , ETC) 



D IN GENERAL, USER SEGMENTS IN THE' HIERARCHY POSE NO DEADLOCK 
PROBLEM SINCE THEY ARE A SIMULTANEOUSLY USABLE RESOURCE (IE: 
THERE IS NO DEFAULT CONCURRENCY MECHANISM ASSOCIATED WITH 
USER SEGMENTS) 



fl SEGMENTS MAY BE PROTECTED FROM POTENTIAL CONCURRENCY PROBLEMS 

THROUGH USE OF LOCK WORDS AND THE set_lock_ MECHANISM. THIS 

REQUIRES MUTUAL AGREEMENT AMONG ALL PROCESSES ACCESSING SUCH 
SEGMENTS 



S SOME SEGMENTS SUCH AS THOSE USED BY THE MULTICS DATA BASE 
MANAGER (MDBM) , USE A "COMMITMENT/ROLLBACK" SCHEME 
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DEADLOCK PREVENTION 



| SUPERVISOR RESOURCES (SUCH AS HARDCORE DATABASE) 

1 LOCKWORDS (OR SIMPLY "LOCKS") ARE USED IN MULTICS TO 
IMPLEMENT CONCURRENT ACCESS CONTROL IN THE MULTI -PROCESS 
ENVIRONMENT 



LOCKING CONCEPT 




0 THE SUPERVISOR LOCKS ARE ARRANGED IN A PARTIAL ORDER AND A 
CODING CONVENTION PREVENTS WAITING ON A LOCK IF THE PROCESS 
HAS A HIGHER LOCK LOCKED 



0 THIS PARTIAL ORDER IS DETERMINED BY AN ANALYSIS OF THE 
OPERATING SYSTEM'S BEHAVIOR. FOR EXAMPLE: SINCE A PAGE 
FAULT MAY PROPERLY OCCUR WHILE A PROCESS HAS THE ACTIVE 
SEGMENT TABLE (AST) LOCKED, AND PAGE FAULT HANDLING REQUIRES 
THE LOCKING OF THE PAGE TABLE LOCK, THE PAGE TABLE LOCK MUST 
BE PLACED "HIGHER" IN THE PARTIAL ORDER THAN THE AST LOCK 



g TO THE DEGREE THAT THE SYSTEM , PROGRAMMERS OBEY THIS PARTIAL 
ORDER, A DEADLY EM3RACE CANNOT OCCUR WITHIN THE MULTICS 
SUPERVI SOR 



Not To Be Reproduced 



3-13 



FSOA 



o 

rt 

• 3 

O 

Ld 
fl> 

fD 

•o 

• t 

O 
P. 

c 
n 

fD 



"J 

CM 

> 



MULTICS LOCKING HIERARCHY 



CONNECT 
(LOOP) 



GLOBAL APT 
(MULTI-READER 
(LOOP) 



APT ENTRY 
(LOOP) 



J 



CORE QUEUE DIS 

(LOOP) (LOOP) 



GLOBAL PAGE TABLE 
(LOOP/WAIT) 



I/O MAILBOX 

.(LOOP) w 

/ \ 

K DATA OC 



OCDCM 
(LOOP) 



SYSERR DATA 
(LOOP) 



MCS QUEUE 
(LOOP) 



♦ 



t 



VTOC BUFFER SEGMENT 
(WAIT) 



t 



ACTIVE SEGMENT TABLE 
(WAIT) 



t 



DIRECTORY LOCK TABLE 
(WAIT) 



t 



ROOT DIRECTORY 
(MULTI-READER, WAIT) 



t 



LOWER DIRECTORY 
(MULTI-READER, WAIT) 



f 



MISCELLANEOUS: IOAT, 101, 
SALV_DATA, RECONFIGURATION 
(WAIT) 



SYSERR LOG 
(WAIT) 



MCS CHANNEL 
(LOOP/WAIT) 



TYPES OF LOCKS 



LOCKS WITHIN MULTICS: ^r D *\ d<^H 

| ARE 36 BIT WORDS CONTAINING EITHER ZERO (UNLOCKED) OR A 
PROCESSED (LOCKED) 

| CONTROL PROCESSES, NOT PROCESSORS 



| ARE MUTUALLY EXCLUSIVE LOCKS 



8 THE HARDWARE SUPPORTS SEVERAL INDIVISIBLE INSTRUCTIONS USED IN 
IMPLEMENTING THE LOCKING PRIMITIVES. FOR EXAMPLE: 



fl STAC (STORE A CONDITIONAL) 



1 IF C(Y)=0 THEN C(A.) -> C(Y) 



Jj TYPICAL USE: LOCKING.- IF THE LOCKWORD (Y) IS UNLOCKED (=0) 
THEN LOCK THE LOCK BY STORING THE PROCESSED (WHICH IS IN A) 
INTO THE LOCKWORD 



| SPECIAL HARDWARE PROHIBITS SIMILAR REFERENCES 3Y OTHER 
PROCESSORS DURING THE TEST AND DATA TRANSFER WINDOW 



0 ALSO STACQ (STORE A CONDITIONAL ON Q) , LDAC (LOAD A AND CLEAR) , 
LDQC (LOAD Q AND CLEAR), SZNC (SET Z AND N AND CLEAR) 
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TYPES OF LOCKS 



s WITHIN THE MULTICS SUPERVISOR EXISTS TWO TYPES OF LOCKS: LOOP 
LOCKS AND WAIT LOCKS 



2 SIMPLIFIED PL/I ANALOGY: 

do while (lockword A =0); 
end; 

lockword = process_id; 
<update data> 
lockword = 0; 



| LOOP LOCKS ARE USED WHEN IT WOULD NOT BE ACCEPTABLE TO GIVE 
UP THE PROCESSOR BEFORE LOCKING THE LOCK. 



| LOOP LOCKS TYPICALLY PROTECT THE LOWEST LEVEL OF CRITICAL 
SUPERVISOR DATABASES: TRAFFIC CONTROL, PAGE CONTROL, ETC. 
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LOOP LOCKS 




TYPES OF LOCKS 



WAIT LOCKS (SIMPLIFIED) 



B A 




B: PROCESS DISPATCHED TO A CPU 



8 SIMPLIFIED PL/I ANALOGY: 

do while (lockword A =0); 
<GIVE UP PROCESSOR> 
<WAIT FOR NOTIFICATION 

end; 

Lockword = process__id; 

Lockword = 0 

<SEND NOTIFICATION 



0 MOST SUPERVISOR LOCKS ARE WAIT LOCKS 



0 IN GENERAL , A PROCESS IS ALLOWED .TO GIVE UP ITS PROCESSOR 
WHEN IT HAS WAIT LOCKS LOCKED 



g THE WAIT LOCK MECHANISM WILL BE DESCRI3ED IN MORE DETAIL IN 
TOPIC 9 
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NAME /ADDRESS SPACE OVERVI EW 

\ 

TI0N TUy ^ i^dj ^ ^"•iw* ^ > ^ 



D IMPLEMENT THE PER PROCESS VIRTUAL MEMORY 
b BASIC PHILOSOPHY 



AS A NEWLY LOGGED IN USER ATTEMPTS TO TOUCH VARIOUS SEGMENTS A 
CONSIDERABLE AMOUNT OF MANAGEMENT INFORMATION MUST BE 
(TRANSPARENTLY) FOUND AND /OR COMPUTED BEFORE THE USER'S 
REFERENCE IS ACTUALLY ACCOMPLISHED 



fl FOR EVERY SEGMENT REFERENCED BY THE USER, THE SUPERVISOR: 

fl ASSIGNS A SEGMENT NUMBER (FOR REASON OF HARDWARE ADDRESSING), 
AND 



RECORDS (REMEMBERS) THE MANAGEMENT INFORMATION (FOR REASON OF 
SOFTWARE EFFICIENCY AND CONTROL) 



0 SUCH SEGMENTS ARE SAID TO BE "KNOWN TO THE PROCESS " 



THE MANAGEMENT INFORMATION IS MAINTAINED ON A PER PROCESS 3ASIS 
IN THREE COMPLEMENTING AREAS: DSEG , KST , AND RNT 
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NAME /ADDRESS SPACE OVERVIEW 



0 MANAGES TWO DISTINCT SETS OF INFORMATION: 



| ADDRESS SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND 
THE SEGMENTS THEMSELVES 



J NAME SPACE - CORRESPONDENCE BETWEEN SEGMENT NUMBERS AND NAMES 
THE USER REFERS TO THEM BY 

\ CALLS DIRECTORY CONTROL TO LOCATE SEGMENTS INITIALLY 



NAME SPACE / ADDRESS SPACE MANAGEMENT IS INVOKED BY SUBROUTINE 
CALLS, AND BY LINKAGE FAULTS (THE "DYNAMIC LINKER" ) 



a PRINCIPAL USER INTERFACES 



1 COMMAND LEVEL 

\ initiate, terminate, terminate^ segno, terminate_ref_name , 
terminate^ single^ ref — name.,- list_ref_name 

0 THE COMMAND PROCESSOR ITSELF - WHICH USES THESE SERVICES TO 
LOCATE COMMANDS 



| SUBROUTINE LEVEL 

\ hcs_$initiate , hcs_$ini t iate_count_, hcs_$terminate_f ile , 
hcs_$terminate_seg, hcs_$terminate~name , 
hcs_$terminate_noname , term_ 
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NAME /ADDRESS SPACE OVERVIEW 

a MAJOR DATA 3ASES 

0 DESCRIPTOR SEGMENT (DSEG) - ONE PER PROCESS 

| SEGMENT DESCRIPTOR WORD (SDW) - ONE PER KNOWN SEGMENT 
J DEFINES THE USER'S ADDRESS SPACE TO THE HARDWARE 

0 KNOWN SEGMENT TABLE (KST) - ONE PER PROCESS 

D KNOWN SEGMENT TABLE ENTRY (KSTE) - ONE PER KNOWN SEGMENT 
(EXCEPT SUPERVISOR SEGMENTS) 

S DEFINES THE USER'S ADDRESS SPACE TO THE SUPERVISOR AND THE 
USER 

0 EACH KSTE ASSOCIATES A USER'S SEGMENT NUMBER WITH THE SEGMENT 
CONTROL ATTRIBUTES OF THAT SEGMENT 

| THE SEARCH FOR AN AVAILABLE KSTE DETERMINES A SEGMENT'S 
NUMBER 

Q REFERENCE NAME TABLE (RNT) - ONE PER EACH RING IN EACH PROCESS 

5 NOT A SEGMENT - KEPT AS A REGION ALLOCATED IN THE "LINKAGE 
AREA" FOR EACH RING 

g REFERENCE NAME TABLE ENTRY (RNTE) - ONE PER REFERENCE NAME 

9 USED BY THE DYNAMIC LINKER TO IMPLEMENT THE 
" initiated_segments' T SEARCH RULE 
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NAME /ADDRESS SPACE OVERVIEW 



J DEFINES THE USER'S NAME SPACE TO THE USER 



NAME SPACE MAY BE DIFFERENT IN DIFFERENT RINGS OF THE SAME 
PROCESS 



fO 1 
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NAME /ADDRESS SPACE TERMINOLOGY 



SEGMENT DESCRIPTOR WORD (SDW): 

A TWO WORD PAIR USED BY THE HARDWARE WHEN REFERENCING A 
SEGMENT. 



DESCRIPTOR SEGMENT (DSEG) : 

THE MOST FUNDAMENTALLY IMPORTANT SEGMENT IN A PROCESS . 
CONTAINS AN ARRAY OF SDW'S DEFINING THE ADDRESS SPACE 
OF THE PROCESS 



ADDRESS SPACE: 

THE SET OF ALL SEGMENTS (PROCEDURE AND DATA) FOR WHICH 
THE PROCESS HAS A SEGMENT NUMBER AND A CORRESPONDING 
SDW. THE ADDRESS SPACE EXPANDS AND CONTRACTS DURING' A 
SEGMENT' S LIFE 

l F yiw yx&/ kef U6^_s 

SEGMENT NUMBER: \> 

AN OCTAL NUMBER 0-1777 (0-1023 DECIMAL ) ASSIGNED 
UNIQUELY TO A SEGMENT. USED BY THE HARDWARE AS AN 
OFFSET INTO THE ARRAY OF SDW'S WHEN REFERENCING A 
SEGMENT 



MAKING KNOWN: 

THE ACT OF ASSIGNING A SEGMENT NUMBER TO A SEGMENT f 

THEREBY ADDING IT TO THE ADDRESS SPACE. SEGMENTS MUST 

BE MADE KNOWN BEFORE THEY CAN BE REFERENCED 
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SPACE: 

THE SET OF ALL SEGMENTS FOR WHICH THE PROCESS HAS A 
REFERENCE NAME. THE REFERENCE NAME MAY BE DIFFERENT 
THAN THE SEGMENTS ACTUAL NAME (ITS ENTRYNAME) . SINCE 
SOME SEGMENTS IN THE ADDRESS SPACE HAVE NO REFERENCE 
NAME, THE NAME SPACE IS A PROPER SUBSET OF THE ADDRESS 
SPACE 
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NAME /ADDRESS SPACE CONCEPTS 



s A MULTICS PROCESS IS A WELL DEFINED COLLECTION OF UNIQUE SEGMENTS, 
EACH WITH DEFINED ACCESS, OVER WHICH A SINGLE EXECUTION POINT IS 
FREE TO ROAM (I.E., FETCH INSTRUCTIONS AND MAKE DATA REFERENCES) 



s THE ADDRESS SPACE OF A PROCESS IS THE ABOVE "COLLECTION OF 
SEGMENTS". SUCH SEGMENTS ARE SAID TO 3E KNOWN TO THE PROCESS 



jj ALL SUPERVISOR (RING 0) SEGMENTS ARE PLACED INTO THE ADDRESS 
SPACE AT PROCESS CREATION TIME. THIS ADDRESS SPACE IS SAID TO 
BE "CLONED" FROM THE INITIALIZER ADDRESS SPACE 



1 THE RING ZERO ADDRESS SPACE IN ANY PROCESS IS THE SAME AS THE 
INITIALIZER'S RING ZERO ADDRESS SPACE, EXCEPT FOR THE DSEG , 
KST , PDS , PRDS , AND STACK 0 



| THE RING ZERO ADDRESS SPACE HAS NO RNT, BECAUSE IT IS SET UP 
DURING SYSTEM INITIALIZATION, AND DOES NOT CHANGE 

V.W S ^5>C4 do<^*N d^ft^L Vv^k.AC^ 5 n vy 



GTHttK SEGMENTS AKfci MAun KNOWN AND UNKNOWN DURING THE LIFE OF 
PROCESS 



0 IMPLICITLY BY THE DYNAMIC LINKER (LINKAGE FAULT) OR A SYSTEM- 
COMMAND 

print my_dir>my_seg 
tester 



D EXPLICITLY BY COMMANDS OR SUBROUTINES THAT MANAGE THE ADDRESS 
SPACE 

initiate my__prog call he s_$ terminate_segno 
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J MAKING A SEGMENT KNOWN IS SIMILAR TO DECLARING A VARIABLE IN A 
PL/I PROGRAM. IT SIGNIFIES INTENT, BUT NOT USAGE 

V?c,pC«?<, 3\6T ^ \CS^T 

S THE PRESENCE OF ONE OR MORE PAGES OF A SEGMENT IN MAIN MEMORY 
IMPLIES THAT THE SEGMENT IS KNOWN TO (AND IS BEING USED BY) AT 
LEAST ONE USER 



| BEING KNOWN DOES NOT IMPLY PRESENCE IN MAIN MEMORY 



NOTE THAT THIS . SET OF SEGMENTS, THE EXECUTION, POINT, AND THE 
REGISTERS AND INDICATORS OF THE PROCESSOR, UNIQUELY DEFINES THE 
STATS OF THE PROCESS 
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NAME SPACE AND ADDRESS SPACE MANIPULATION 



© PROCESS CREATION 



(5) INITIATE WITHOUT 
w REFERENCE NAME 



® 



INITIATE WITH 
REFERENCE NAME 




THE rnt IS AN AREA WITHIN [pd] > [unique] .areaJinker 
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NAME SPACE AND ADDRESS SPACE MANAGEMENT 



267 qedx 



272 cwd 



266 pll 



267 qx 



RNT 

(USER'S NAME SPACE) 





KSTE FOR cwd 



KSTE FOR seg_3 



KSTE FOR qedx 



KSTE FOR pll 



KST 





PER PROCESS I 


PER SYSTEM 




DATA BASES 
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► 

DATA BASES 










271 


SDW FOR cwd 




PT FOR qedx 


270 


SDW FOR seg_3 


/ 


PT FOR seg_1 


267 


SDW FOR qedx 




PT FOR pll 


266 


SDW FOR pll 


/ 


PT FOR A.pl1 




DSEG 




PAGE TABLES* 



PAGE 4 OF qedx 



PAGE 3 OF pll 



PAGE 41 OF xyz 



PAGE 16 OF pll 



MAIN MEMORY 
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(USER'S ADDRESS SPACE] 



(SYSTEM'S ADDRESS SPACE) 



THE ASTE'S ASSOCIATED WITH THE PAGE TABLES ARE NOT SHOWN IN THIS DIAGRAM 



o 



o 

MULTICS VIRTUAL MEMORY STRUCTURE 

o 



(1> USER A t USER A s USER A'l 

ADDRESS SPACE VIRTUAL MEMORY SEGMENT TABLE 




USERBs USERB i USER B i SYSTEM'S PAGE 

ADDRESS SPACE VIRTUAL MEMORY SEGMENT TABLE TABLES 

(ONE ENTRY PER (ONE PER ACTIVE 

KNOWN SEGMENT) SEGMENT) 



OO 
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138 



0 










1 




POINTER TO ALLOCATION AREA 




2 


INSERT TRYS 


INSERT WINS 


3 


GET_SEG_NO TRYS 


GET_SEG_NO_WINS 


4 


GET_RNAME TRYS 


GET_RNAME WINS 


5 


DELETE_SEG_NO TRYS 


DELETE_SEG_NO WINS 


6 


DELETE_NAME TRYS 


DELETE_NAME WINS 


7 




RNT AREA SIZE 


8 
9 


SEARCH RULES POINTER 


10 





128 WORDS FOR 
REFERENCE NAME HASH TABLE 



128 WORDS FOR 
SEGMENT NUMBER HASH TABLE 



— . ■ I . — ■ 1 ■ ■ — 




NAME FORWARD R_PTR 


(TO SAME HASH) 




SEG_NO FORWARD R_PTR 


(TO SAME HASH) 


SEG_NO 




NAME LENGTH (Li 


1 ■ ! ■ ' 



= 2 



E 



L CHARACTERS CONTAINING 
SEGMENT'S REFERENCE NAME 



*- Z 
O = 



REFERENCE NAME TABLE (RNT) 

A PAGED DATA BASE ( |pd] > rnt) - ONE PER ACTIVE PROCESS 
"INITIATED SEGMENTS" IN SEARCH RULES 

REFERENCE NAME TABLE ENTRY (RNTE) 

ONE PER REFERENCE NAME 



frnt.ictd.pll i 
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KNOWN SEGMENT TA3LE (KST) 
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64 WORD ARRAY FOR UIO HASH TABLE 



FORWARD R PTR 



SEGMENT NUMBER 



NUMBER 



OF 



TIMES 



THIS 



SEGMENT 



INITIATED 



(PER 



RING) 



BRANCH ENTRY POINTER 



SEGMENTS UNIQUE IDENTIFIER (UIO) 



□ATE TIME BRANCH ENTRY MODIFIED (DTBM) 



EXTENDED ACCESS 
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OTHER KSTE^s 
ONE PER INITIATED SEGMENT 



256 WORD LIST OF PRIVATE LOGICAL 
VOLUME CONNECTIONS 



-WOROS) 



ENO OF KST 



KNOWN SEGMENT TABLE (KST! 

A 9£H PROCESS DATA 3ASE ;pci -» <$ti ONE PER ACTIVE 'RCCSSS 
NOT WIRED £NCACnEABL=> 

KNOWN SEGMENT TABLE ENTRY KSTE'. 
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(WORDS) 




DESCRIPTOR SEGMENT (DSEG) 

A PAGED ([pd] > dseg) DATA BASE - ONE PER ACTIVE PROCESS 

SEGMENT DESCRIPTOR WORD (SDW) 

ONE PER INITIATED SEGMENT IN PROCESS (MAX 1024) 



(sdw.incl.pl 1) 
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NAME/ADDRESS SPACE DATA BASES 
DESCRIPTOR SEGMENT (DSEG) 



SEGMENTS IN THE MULTICS HIERARCHY 



INITIATED WITH 
REFERENCE NAME(S) 



INITIATED WITHOUT - 
REFERENCE NAME 

SUPERVISOR 
SEGMENTS 



MUST CONNECT USER 
TO CURRENTLY ACTIVE 
SEGMENT -OR- 
RECONNECT BECAUSE 
OF ACL CHANGE, POOL 
PROMOTION, ETC. 



\ 



ACTIVE SEGMENTS 



V 



UNPAGED 
SUPERVISOR 
SEGMENTS — 
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NOT IN USER'S RNT 



IN USER'S KST 
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:|:SNOT IN USER'S KST 



IN USER'S DSEG 
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VALID 8W.I II FAULTED 
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HAS A PAGE 
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STATES OF SEGMENTS AND PAGES 
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TYPICAL ADDRESS SPUCi 



COLLECTION ZERO 



I SEGMENTS WHiCH MUST BE PRESENT TO RUN THE VERY FIRST LOADING 
PROGRAM 



I SEGMENTS WHICH HAVE FIXED ABSOLUTE ADDRESSES TO INTERFACE WITH 
HARDWARE ■ 



I ALL DESCRIBED IN temp 1 ate_s lt_. cos 



0 [pd]>dseg (ring 0) 

The descriptor segment. The Initializer's dseg 
comes from the system tape and is built during 
system initialization; all others are created by 
process creation. 

1 f aul t__vector (ring 0, perm-wired) 

Contains the interrupt vector, fault vector, and the 
ITS pairs for SCU and TRA instructions. Located at 
absolute locations 0-577- Used by the CPU hardware. 

2 iom_mailbox (ring 0, perm-wired) 

Mailboxes (communications areas) for up to four 
lOMs. Located at locations 1200-3377 absolute. 
Used by the I OM hardware. 

3 >s 1 l>conf t g_deck (ring 0, deciduous) 

The online copy of the config deck. This is built 

from the config deck provided by BOS during system 

initialization, but it is not the copy BOS actually 
uses . 

k dn355_rca i 1 box , (ring 0) 
Mailboxes (communications areas) for up to eight 

FNPs. Located at absolute locations 3400-6377- 
Used by the FNP hardware. 

5 bos_toehold (ring 0, perm-wired) 

The segment containing the tiny program used to 
switch between Multics and BOS at crash time. 

Located at aosolute locations 1 0000- 11777- 
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6 flagbox (ring 0, perm-wired) 

A region inside the bos_toehold segment (yes, it 
really overlaps the toehold) used to access the 
BOS/ftultics communication region. 

7 >sll>s!t (ring 0, deciduous) 
10 >sl l>name_table (ring 0, deciauous) 

The two primary databases of system initialization. 
The SLT contains one entry for every supervisor 
segment read from the system boot tape, containing 
all its attributes. The separate name_table is used 
to hold the names, because each segment may have 
several 

This marks the end of Collection Zero. All the rest of the segments in the 
address space are either read from the system tape or found in the online 
system. 
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s COLLECTION ONE 



I FIRST BATCH OF SEGMENTS READ FROM SYSTEM TAPE 



I ALL THE PROGRAMS AND DATABASES NEEDED TO MAKE PAGING RUN 



I ALL SEGMENTS WHICH MUST BE "perm-wired" — PERMANENTLY ALLOCATED IN 
LOW MEMORY, WITHOUT PAGE TABLES 



11 lot . • ... (ring 0) 

The supervisor's linkage offset table. Used to find 
1 i nkage' sect ions . Built as the segments are read in 
from tape. 

12 as_linkage (ring 0) 

13 ws_l i nkage (ring 0) 

The permanent supervisor combined linkage regions. 
The names mean "Active Supervisor Linkage" and 
"Wired Supervisor Linkage", respectively. The 
linkage sections of all permanent supervisor 
segments are put in one of these as the segments are 
read from the tape. 

lit >sl l>def initions_ (ring 0, deciduous) 

The segment containing all the definitions sections 

of supervisor programs. The definitions sections 

are placed here as the programs are read from the 
tape, and used by the hardcore prel inker. 

15 sst_seg (ring 0, perm-wired) 

The segment containing all ASTEs and page tables. 
Covered in under Page and Segment Control. This 
segment is allocated at the very top end of the 
bootload SCU. 

16 core__map (ring 0, perm-wired) 

A11 the core map entries, describing all system 
memory. Covered under Page Control. This used to 
be part of the SST, but was moved out to make more 
room for page tables. 

17 abs_seg (ring 0, abs-seg) 

An abs-seg used for complex call-side operations in 
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20 



21 



page control , 
reconf igurat ion. 



such 



as 



evi ct_page 



and 



abs_segl (ring 0, abs-seg) 

An abs-seg used only by page control for checking 
page frame contents for zeros, and zeroing newly 
allocated page frames. 



backup_abs__seg 

An abs-seg used to access the 
in a Volume Dumper process, 
which refers to any ordinary 



(ring 0, abs-seg) 
segment being dumped 
It i s g i ven an SOW 
segment. This is a 



very special hardcore segment, because it has. 
trailer entries, and it is spec i a 1 -cased by the 
trailer manipulation program, setfaults. Normal 
hardcore segments never receive trailers, 'since they 
are. never activated or deactivated. 



22 fim_abs__seg 

An abs-seg used by the FIM to do something 



(ring 0, abs-seg) 



23 i sol ts_abs_seg (ring 0, abs-seg) 

An abs-seg used by 1 S0LTS, which gives it an SDW 
describing the low £4K of the SCU being used for 
IS0LTS testing. 

2k volmap_abs_seg (ring 0, abs-seg) 

An abs-seg used by page control to access record 
stocks. !t is given the SDW of whichever volume's 
stock i s needed . 



25 bound_acti ve_l 

26 bound_di sk_ut i 1 

27 bound_d i sk_ut i l_wi red 

30 bound_error_act i ve 

31 bound_error_wi red 

32 bound_i nterceptors 

This is where the FIM lives. 



(ring 0) 

(ring 0) 

(ring 0, per.m-wi rec) 

(ring 0) 

(r i ng 0, perm-wi red) 

(ring 0, perm.-wired) 



33 bound_io_wi red (ring 0, perm-wired) 

34 bound_J om_suppor t (ring 0, . perm-wi red) 

35 bound_page_control (ring 0, perm-wired). 

36 bound_ pr iv_l (ring 0, perm-wired) 

37 >s 1 l>bound_sss_wi red_ (ring 0, deciduous) 

This is where pi l_operators_ and a whole host of 
other miscellaneous subroutines live. It is wired 
in a very special way, because not all of i ts 
contents need to be wired. In particular, only 
about half of p 1 l_operator s_ needs to be wired, and 
there is a special hack in make_sdw.pll which finds 
the definition in the middle of pi l_o?erators_ which 
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marks the end of the wired portion, and makes an 

ASTE for bound_sss_wi red_ which has all its pages up 

to and including that definition wired, and the rest 
unw i red . 



1+0 bound_tc_pr i v 

1+1 bound_tc_wi red 

1+2 bound_unencacheab 1 e 

1+3 dir_seg 

An abs-seg now used only at process 
to loop through the dead process's 



45 



(r ing 
(ring 
(ring 
(r i ng 

termination time 
KST in order to 



0, perm-wired) 

0, perm-wired) 

0, perm-wired) 

0, abs-seg) 



flush any trailers it had for active segments 
1+1+ d i sk_post_queue_seg 



(ring 0, perm-wired) 



The segment where the core address queue lives:, see 
core^queue^man.alm.. This is discussed under Page 
Control . 

disk__seg (ring 0, perm-wired) 

The segment containing the disk DIK's databases: 
device table, channel table, and 1/0 queues. 



1+6 dn355_data 



(ring 0, perm-wired) 



The segment containing software communications 
regions for the FNPs. This is not where FNP buffers 
are kept, but only the mailboxes that describe the 
buffers, and some control information. 

47 ds_seg (ring 0, abs-seg) 

The segment used by setf suits when accessing another 
process's DSEG in order to remove a trailer. 
Covered under Segment Control . 

50 emergency_shutdown (ring 0, perm-wired) 

The procedure segment which starts an ESD. It is a 
separate segment because BOS has to be able to f i nd 
it and transfer to i t . 

51 hardcore_sct_seg (ring 0) 

The segment containing the static condition table 
for ring zero; it's just like the one which is kept 
in an outer ring stack header. The only static 
handlers in ring zero are those used to invoke the 
ccpy_on_wr i te mechanism. 

52 idle_dsegs (ring 0, perm-wired) 

53 idle_pdses . (ring 0, perm-wired) 

Two similar segments: they contain the DSEG and PDS 
segments for all the idle processes, all in a row. 
When an idle process is constructed, the SDWs for 
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57 



its DSEG and PDS are set up to point into the middle 
of one of these segments. 



i ni t_processor 
i nzr_stkQ 

The stack segment used by the' 

initialization and shutdown. 

operation, the Initializer 

ring zero stack sharing. 



56 iobm_data 



(ring 0) 
(ring 0) 
Initial i zer dur i ng 
During normal 
participates in ordinary 



(r i ng 0 , perm-w i red) 



The database of ■ iobm.pl 1, the I/O Buffer Manager. 



i oi_abs_seg 

The abs-seg used by ibiVinterrupt.pl 1 
; user ioi_ buffer at interrupt time, 

status information. 



(ring 0, 
to access a 

for storing 



abs-seg) 



60 ioi_data (ring 0, perm-wired) 

The database for ioi_ — describes all 
user-accessab 1 e, or potentially user-accessab 1 e 
devices. See the programs in bound_i o__act i ve and 
bound io wired. 



61 



62 



63 



0, perm-wired) 



iom_data (ring 0, perm-wired) 

Describes the configuration of the lOMs, and 
software information about I 0M channels. Contains 
assignment information, software status queue 
location, and metering cells. 

oc_data • (ring 

The database for the ring zero operator's console 
mechanism. This Is used by syserr in ring 2ero, and 
by the Initializer to write on the system console 
(but not message coordinator consoles). 

[pd]>pds (ring' 0, deciduous) 

The Process Data Segment. This contains all the' 
miscellaneous information that makes a process 
supervisor, and need not be readily 
other processes. Most per-process 
referenced symbolically, such as 
pds$page_f aul t_data (machine 
ast page fault), etc. 



unique to the 
accessabl e " to 
variables are 
pdsSprocess id, 
conditions for 



>s 1 l>prds (r i ng 

Like the PDS, but- per-processor . Contains the same 
sort of miscellaneous information, and is also used 
as the ring zero stack for certain types of faults 
(page faults, connects, and timer runouts) and all 
interrupts. There is a PRDS oer crocessor, named 



0, deciduous) 
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>s 1 l>cpu_A .press , cpu_B.prds, etc. The PRDS segment 
in ring zero is changed at LDBR time to indicate the 
actual PRDS of the processor that the process is 
going to run on; thus, it's sort of an abs-seg. All 
PRDS 's are wired, but have page tables. 



65 >sll>pvt 

The Physical Volume Table. Described 
Management and Page Control . 



(ring 0, deciduous) 
unver Volume 



66 rdisk_seg (ring 0, abs-seg) 

A PTW- type abs-seg (the only one where the PTW ever 
changes). Used only by the program read_disk, which 
does I/O to arbitrary pages on any disk, its 
aste.pvtx and PTW are switched around to indicate 
the right page,- which is. faulted on and (if. needed), 
written back out by pc$cleanup. 



67 restart_f aul t 

70 return_to_r i ng_0_ 

These two procedures 
restarting of faults 
the user ring. When 



(ring 0) 
(ring 0) 

are used to implement the 
(such as a QUIT signal) from 

a fault occurs, a frame is 



pushed on the user ring stack, with its owner set to 
be return_to__r i ng_0_. Additionally, the machine 
conditions for the fault are saved in ring zero (in 
the PDS) so that when restart_f aul t is called to 
restart a possibly modified set of conditions, it 
can compare and validate. 



7i 



seas (r i ng 

The System Controller Addressing Segment. This 
segment has a page overlaid on a page of every 
system controller. No data is ever accessed through 
this segment; its page table is not even in the SST, 
but in the SCS. It is used only for certain 
privileged instructions which require an effective 
address in an particular SCU in order to read or set 
control registers in the SCU. 



v , aw 9 



72 scs (ring 0, perm-wired) 

The System Configuration Segment. It describes most 
of the hardware configuration, and contains various 
control words used by privileged control 
instructions. 



s i gnal 1 er 

The procedure 
s i gnal 1 i ng . 



which implements user ring 



(ring 0) 
faul t 
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74 >s 1 l>sst_names_ (ring 0, deciduous) 

The SST name table. This is a debugging feature; it 
contains (when in use) the primary name 
corresponding to every segment in the AST. It can 
be maintained online, by use of the PARM ASTK config 
card, but usually is not. it is always filled in by 
FDUMP after a crash if it was not already in use. 

75 stack_0__data (ring 0, perm-wired) 

Data segment describing the available segments for 
use in ring zero stack sharing. These segments, 
seen later on as segment 230, are recorded here and 
multiplexed among eligible processes. 

76. stoek^seg ' (ring 0, perm-wired) 

The segment containing all in-core record and VTOCE 

stocks for use by page control and segment control, 
and covered under those topics. 

77 >s 1 l>sys_boot_i nf o (ring 0, deciduous) 

A data segment containing information about the I/O 
devices (tape and disk) used during bootload. 

100 >s 1 l>sys_J nf o (ring 0, deciduous) 

Contains assorted global wired information shared by 
the user ring and supervisor. Some is set during 
bootload, and some comes off the tape; none is 
modified after initialization is complete. 

101 syserr__data (ring 0, perm-wired) 

Data segment for the lowest level of the syserr 
mechanism. Syserr messages are built and queued 
here, and sent to the console. They are also copied 
out by the syserr logger hardcore process, into the 
syserr_log. 

102 syserr_log (ring 0, abs-seg) 

This segment overlays the LOG partition on some 
disk, which is used to reliably store syserr 
messages until they can be copied into the 
perm_syserr_log maintained in the Hierarchy. 

103 tc_data (r i ng 0) 

The traffic control data segment; contains all 
traffic control data. Covered under Traffic 
Control . 

10k wi red_hardcore_data (ring 0, perm-wired; 

Miscellaneous data used by the wired supervisor. 



Not To Be Reproduced 



ix-23 



F80A 



TYPICAL ADDRESS SPACE 



e COLLECTION TWO 



I THE UNW I RED PORTION OF THE SUPERVISOR 



READ IN BY COLLECTION ONE, DIRECTLY 
SEGMENTS IN THE HARDCORE PARTITIONS 



INTO PAGED 



105 >sH>active_al l_r ings_data (ring 0, deciduous) 

Miscellaneous data shared between the unwired 
supervisor and the outer rings. 

106 acti ve__hardcore_data (ring 0) 

Miscellaneous data used by the unwired portion of 
the supervisor: system-wide locks, si2e constants 
for directory control, system search rule info, and 
metering for directory control and the dynamic 
1 i nker . 



107 


>s 1 l>admi n_gate_ 




(r ing 


0, 


110 


ast_J ock_meter_seg 




(ring 


0) 




A segment used to 


col 1 ect 


AST lock metering, 






normally off (enabled 


by 


the ast_lock_meter ing 






tuning parameter) . 








1 1 1 


>s 1 l>aud i t_gate_ 




(ring 


0, 


112 


bound_355_w i red 




(ring 


0) 


113 


bound_f i 1 e_system 




(r i ng 


0) 


114 


bound_hc_backup 




(r ing 


0) 


115 


bound_hc_reconf i g 




(r i ng 


0) 


116 


bound_hc_tun i ng 




(ring 


0) 


117 


bound_imp_d im_ 




(ring 


0) 


120 


baund_i mp_s tatus 




(ring 


0) 


121 


bound_ i o_act i ve 




(r ing 


0) 


122 


bound_mcs_ut i 1 




(ring 


0) 


123 


bound__pr 1 vjnpx 




(r i ng 


0) 


124 


bound_networkO_ 




(ring 


0) 


125 


bound_pr i v_procs 




(ring 


0) 


126 


bound_process_creat i on 




(ring 


0) 


127 


bound_sa 1 vager 




(ring 


0) 


130 


bound_scavenger 




(ring 


0) 


131 


>sl l>bound_sss_act i ve_ 




(r ing 


0, 


132 


bound_system_f aul ts 




(ring 


0) 


133 


bound_tty_act i ve 




(ring 


0) 


134 


bcund_vtoc_man 




(r i ng 


0) 


135 


bound_x25_mpx 




(r i ng 


0) 



, aecicuous; 



dec i duous) 
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136 dbm_seg (ring 0) 

The segment used to hold the dumper bit maps for 
volumes being volume-dumped. The bitmaps are read 
from the volume header when a dump begins, and 
written back when finished. 

137 dirlockt_seg (ring 0) 

The segment used to keep track of all directory 
locks. Directory locks are kept in a supervisor 
segment, rather than in directories themselves. 



12*0 


>s 1 l>dm_hcs_ 


(ring 


0,. 


dec i duous) 


141 


>sl l>dm_ journal_seg_ 


(ring 


0, 


dec i duous) 


1.42 


>sl l>error_tabl e_ 


(ring 


0, 


deciduous) 


143- 


\ f^p_d.ump^segv * •'• i *- ■■ .- • "• 


• (ring 


0) 






Segment used for data . buff er i ng by FNP 


dump and 








patch operat ions (but not boot load) . 









144 hasp_mpx 

145 >sl l>hc_backup_ 

146 >sll>hcs_ 

147 >sl l>hphcs_ 
150 ibm3270_mpx 
IS 1 imp_data 

152 imp_dim_buf_ 

153 imp_tables 

154 imp_wi red_buf f ers 

These four segments were used by 
DIM (part of. the ARPAnet support) 
been decomi ss ioned. 



(r i ng 0) 
(ring 0, 
(ring 0, 
(ring 0, 
(ring 0) 
(ring 0) 
(ring 0) 
(ring 0) 
(ring 0) 
the ring zero IMP 
which has since 



dec i duous) 
dec i duous) 
dec i duous) 



155 I n 1 tial i zer__abs_seg (ring 0, abs'-seg) 

An abs-seg used solely in order to copy a process's 
stack_0 segment into its process directory on 
process termination. 



156 >sl l>ini tiai i2er_gate_ (ring 

157 i o_page_tab 1 es (ring 

The segment which contains page tables, used for 1/0 

if the I0M is operating in Paged mode. It is 

i ni t i al i zed by i oi_i ni t and used only for io?_ I/O. 

160 ioat (ring 
The 1/0 attach table. This is a largely obsolete 
database, the relic of an earlier 1/0 device 
attachment scheme. It is now used only for loading 
and dumping FNPs. 



0, 
0) 



0) 



dec i duous) 



161 >sll>ioi_ 
62 [pd]>kst_seg 



(ring 0, deciduous) 
(ring 0, deciduous) 
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The Known Segment Table. 
Address Space Management. 



Described in Name & 



163 Wt 

The Logical 
Management . 



Volume Table. Described in 



(ring 0) 
Vo 1 ume 



164 
165 



166 
167 
170 
171 
172 
173 



174 
175 
.176 
177 
200 



201 
202 
203 



204 



>s 1 l>mhcs_ 

ncp__tables_ 

Another part of the now-decommissioned 
ARPAnet support, no longer used. 



(ring 0, deciduous) 
(ring 0) 
rino zero 



>s 1 l>net_r i ng0_adm i n_ 

>s 1 l>net_r i ng0_sys_ 

>s 1 l>net_r i ng0_user_ 

>sll>phcs_ ■ 1 . ;:' 

po 1 1 ed_v i p_mpx 

pv_sal v__seg 

This data segment is created in order 
physical volume salvager (now rarely 
contains various databases used by the salvager. It 
is created (by calling grab_aste.pl 1) and destroyed 
for each volume salvage, in each process running a 
salvage, rather than being a shared segment. 



(ring 0, deciduous) 
(ring 0, deciduous) 
dec i duous) 
deciduous) 



(ring 0, 
(r i ng 0 , 
(ring 0) 
(ring 0) 
to run the 
used) . I t 



sa 1 v_abs_seg_00 

sa lv_abs_seg_01 

sa i v_aDS_seg_02 

sa 1 v_abs_seg_03 

sal v_abs_seg_Q4 

These five segments are used 
a volume being salvaged, 



(ring 0, abs-seg) 

(ring 0, abs-seg) 

(ring 0, abs-seg) 

(ring 0, abs-seg) 

(ring 0, abs-seg) 

to overlay the VT0C of 

and are set up and 



referenced by vm_vio.pl 1. 
Salvagers . 



Covered under File System 



sa 1 v_ci i r_space (ring 0) 

salv_data (ring 0) 

sa 1 v_temp_d i r (ring 0) 

These three segments are used by the directory 
salvager when invoked as the online salvager, in 
response to a crawl out or bad_d i r_ condition. Only 
one instance of the online salvager may be running 
at a time, and this is ensured by a lock on 
salv_data. The online salvager does not interfere 
with demand directory salvages, however. Covered 
under File System Salvagers. 

scavenger_data (ring 0) 

The segment containing the tables used when running 
the online volume scavenger. As many volumes as 
tables can be fit nere may be scavenged at one time. 
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The in-use portion of the segment is wired while a 
scavenge is being done. Covered under File System 
Salvagers. 

205 >sll>shcs == (ring 0, deciduous) 

206 str_seg (ring 0) 

The segment trailer segment. The trailers in this 
segment record which processes have an SDW for- any 
particular non-supervisor segment, and the 
backup_abs_seg (see above) . Covered under Segment 
Control . 



207 
210 
211 



212 
213 
214 



syserr_daemon_dseg 
syserr_daemon_ pds _ 
syserr jdaemoh_stack 

The . OS EG, PDS; and 
* logging daemon, 
pfocesss (which 
created. They 
space primarily 
purposes . 



(ring 0) 
(r i ng 0) 
- ..(ring 0) 

ring zero stack of the syserr 
They are filled, in when the daemon 
runs entirely in rfng zero) is 
are in the global system address 
for debugging and recordkeeping 



>s 1 l>system_pr i vi 1 ege_ (ring 0, deciduous) 

>sll>tandd_ (ring 0, deciduous) 

template_pds (ring 0) 

A template for the PDS, used when creating a 

process. it is a copy of the pds template which 

came off the system tape, but which was used to 
create the initializer's PDS. 



215 tty_area (ring 0) 

An unwired database used by ring zero communications 
system, used primarily for saved metering 
information on each channel. 

216 tty_buf (ring 0) 

The important segment in the ring zero 
communications system. Contains the logical channel 
table, all communications 1/0 buffers, and all 
multiplexer databases. 

217 tty_tables (ring 0) 

An unwired database used by ring zero communications 
system to keep the tables used for input and output 
translation/conversion. 



220 vtoc_buf f er_seg (ring 0) 

The segment containing all buffers for VTOC I/O, and 

a small amount of control information. Covered 
under Segment Control . 
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221 «unused» 

222 «unused>> 

223 «unused» 
221+ «unused» 

225 «unused» 

226 «unused» 

227 «unused» 

These segments are unused, since the first segment 
after the supervisor address space is the ring zero 
stack, and its segment number must be zero mod 8. 

230 >s 1 l>stack_0.016 (ring 0, deciduous) 

The ring zero stack. One is allocated from a pool 
(>s 1 l>stack_0.NNN) whenever a process becomes 
eligible. When a process is not eligible (blocked, 
usually), it has no ring zero context, and needs no 
ring zero stack. 

231 [pd]>stack_l 

232 «not used» 
232 «not used» 
23^ [pd]>stack_l* 

The rest of the stacks. There would be others if 
other rings were being used. A stack is created for 
each ring as it is needed; the segment number is 
automatically generated by the CALLS instruction 
(from DBR. stack) , and when a segment fault occurs on 
a stack not yet extant (pdsSstacks (r i ng) is null), 
seg_fault.pl! calls makestack .pi 1 to create one. 
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s NON-SUPERVISOR SEGMENTS 



I 


REMAINDER OF A PROCESS ADDRESS SPACE. 




I 


BUILT BY THE NORMAL NAME AND ADDRESS SPACE MANAGEMENT 




MECHANISMS AS THE PROCESS GETS GOING AND RUNS 




I 


DIFFERENT IN DIFFERENT PROCESSES; THIS IS 


ONLY AN 




EXAMPLE 










240 


> 


(the ROOT) 




The ROOT directory. The recursive nature 


of the 




initiate/segment fault mechanism ensures that this 




will be the first non-supervisor segment 


in the 




address space. 




241 


>pdd 


(d i rectory) 


242 


>pdd 




243 


>sss>bound_process_i ni t_ 




244 


>udd 


(d i rectory) 


245 


>udd>MED 


(d i rectory) 


246 


>udd>MED>Sibert 


(d i rectory) 


247 


[pd]>!BBBMjzKmkcngb.area. 1 inker 




250 


>sss 


(di rectory) 


251 


>unb 


(d i rectory) 


252 


>sl 1 


(d i rectory) 


253 


>tool s 


(d i rectory) 


254 


>am 


(d i rectory) 


255 


>sl l>bound_sss_acti ve_ 




256 


>s 1 l>operator_poi nters_ 




257 


>s 1 l>bound_ss-s__wi red__ 




260 


>s 1 !>bound_process_env_ 




261 


>s1 l>hcs_ - < 




262 


[pd]>pit~ 




263 


>s1 l>bound_error_handlers_ 




264 


>s 1 l>bound_i pc_ 




265 


>sss>bound_as_requests_ 




266 


>sss>bound_i nf o_rtns_ 




267 


>scl 


(d i rectory) 


270 


>scl>whotab 




271 


>sc 1 i nstal 1 at i on_parms 




272 


>s 1 l>sys_i nf o 




273 


>sss>bound_command_I oop_ 





Not To Be Reproduced 



4-2S 



TYPICAL ADDRESS SPACE 



274 >sc l>command_usage_counts 

275 >sc l>command_usage_counts>command_usage_l ist_ 

276 >scl>command_usage_counts>command_usage_total s 

277 >sss>bound_exec_com_ 
300 >sl l>error_tabl e_ 
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system 1 i nk meters 



» SYSTEM_L i NK — METERS - RECORDS CPU TIME AND PAGING INFORMATION USED BY THE 
DYNAMIC LINKER IN ALL PROCESSES 



Linkage Meters: 
CPU Meter ing time 

Total time in 1 i nker 
Average time per link 
Percentage of real time in linker 

Percentage of CPU time in linker 

Time slot (msec) . <25 

' CaVf i I?';:" y--\:^ : ':-. ■ i98tf69 ' 

Total time in slot 0:42:03 

Percent total time 82.63 

Percent total calls 98-06 

Average time 5 .06 

Average page faults 0.18 

Segment Search 

Average time 2.58 

Average page faults 0.04 . 

Percent time in slot 57.06 

Get Linkage 

Average time 0.84 

Average page faults 0.06 

Percent time in slot 18-54 

Definition Search 

Average time 0.24 

Average page faults 0.02 

Percent time in slot 5.26 



4:58:57 

0:50:53 
6.01 msec. 

17.03 
4.66 1, 



1 25-50 " .50-75 / >75 

■ " .8357 ■'" • ■•• - ;v ' ■ U4' : • •• ■ ■ vm. 

0:04:16 0:00:24 0:04:09 

8-40 0.81 . 8-16 

1.64 0.08 0.22 

30.68 59.63 226-59 

•2.29 6-34 5-65 

25*13 53-15 8.70 

0.95 3.53 0.22 

82.58 86-46 3-80 

4-08 7-16 219.16 

0-62 0.93 5-33 

13.41 11.64 95.71 

0.24 0.23 0.20 

0.11 0.24 0.00 

0.80 0.37 0.09 
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1 i nk meters 

o l!NK_METERS - RECORDS CPU T I ME AND PAGING INFORMATION USED BY THE 
DYNAMIC LINKER IN THE PROCESS RUNNING IT 



L i nkage 


Meters : 










slot 


call s 


avg time 


avg pf 


tot time 


% time 


<25 


12^5 


4.689 


0.3 


5-838 


76.1 


25-50 




30.201 


2.9 


1.027 


13.4 


50-75 


6 


62.226 


6.2 


0.373 


4.9 


>75 


2 


216-545 


6.0 


0.1*33 


5.6 


Total 


1287 


5-961 


O.i. 


7.671 
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display kst entry 



fi 0 i SPLAY KST ENTRY - DISPLAYS INFORMATION FROM A KST 



! display_kst_entry >udd>Mul tics>Sibert 

segno: 246 at 162)270 
usage: 0 . 0 , 0 . 0, 0, 0 

entryp: (£4Fl20750$^^ — ->^</> r^T 




uid: 10250 

dtbm: 446556324757 

nodes ■ y- <?: (OV-Oi, 0) ^ ; .- 

ex mode? 70000000000 (7 » 7. l>~SpA 
"ihfeouht:" 3 . " : V .' 

h'dr r ' ■■ •' ; ip" >: " - - '- v -*> 

flags: dirsw write tms 



1 
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Directory Control 



Directory Control Overview . 
Directory Control Terminology 
Directory Control Data Bases 

Directory Segments . . . 

Directory Header . . 
. Directory Entries.' » , w 
Directory Control Commands . 

display_branch . . . 6 . 



DIRECTORY CONTROL OVERVIEW 



a FUNCTION 



8 DIRECTORY CONTROL IS A SET OF HARDCORE MODULES RESPONSIBLE FOR 
THE MAINTENANCE OF THE MULTICS DIRECTORY STRUCTURE — IE: THE 
HIERARCHY 



| ITS TASKS INCLUDE CREATING, MANIPULATING AND INTERPRETING THE 
CONTENTS OF DIRECTORY SEGMENTS , TO INCLUDE: 

I' ACCESS 1 ' CONTROL LI STS ( ACL ? S ) > NAMES ', AND VTOCE POINTERS OF 
. ENTRIES DESCRIBED THEREIN .. 



8 ONLY DIRECTORY CONTROL IS ALLOWED TO ALTER .THE CONTENTS OF 
DIRECTORY SEGMENTS 



DIRECTORY CONTROL IMPLICITLY RELIES UPON THE SERVICES OF OTHER 
SUBSYSTEMS SUCH AS SEGMENT CONTROL AND PAGE CONTROL, AND ALSO 
INVOKES THEM DIRECTLY BY SUBROUTINE CALL 



8 DIRECTORIES ARE SIMPLY SEGMENTS TO THESE SUBSYSTEMS 



1 DIRECTORY CONTROL IS INVOKED ONLY BY SUBROUTINE CALLS 



s PRINCIPAL USER INTERFACES 



8 COMMAND LEVEL 
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A create, create_dir, link, set_acl, delete_acl, status, list, 
addjiame, rename 

D SUBROUTINE LEVEL 

0 hcs_$append_branch, hcs_$add_acl_entr ies , hcs_$append_link , 
hcs__$delete_acl_entries , hcs_$status_, hcs_$chname_f ile 



B MAJOR DATA BASES 



| DIRECTORY SEGMENTS 

| CONTAIN THE ATTRIBUTES AND OTHER INFORMATION ABOUT THEIR 
SEGMENTS (NEEDED TO FIND SEGMENTS, RETURN STATUS INFORMATION, 
AND BUILD VTOCE'S AT SEGMENT CREATION) 



5 THE DIRLCCKT_SEC- 

l SEGMENT WHERE DIRECTORY LOCKING IS MANAGED 
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seg_ 1 



Student_0 1 

Prince hw_dir add.pll 



ATT'S 




ATT'S 




ATT'S 




ATT'S 



hw dir 
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UNIQUE ID (UID)A 36-BIT ID (SERIAL NUMBER) ASSIGNED TO EVERY SEGMENT 
WHEN CREATED 



SON: OF A DIRECTORY. AN IMMEDIATELY INFERIOR (SUBORDINATE) 

SEGMENT 



SON'S LVID: OF A DIRECTORY, THE ID OF THE LOGICAL VOLUME ON WHICH 
. THE DIRECTORY'S SONS RESIDE (AND WILL RESIDE) 



GRANDSON : OF A DIRECTORY. A SEGMENT INFERIOR BY MORE THAN ONE 

HIERARCHICAL LEVEL 



PARENT: Of A SEGMENT. THE "CONTAINING" DIRECTORY SEGMENT 



ANCESTOR: OF A SEGMENT. THE PARENT, OR GRANDPARENT, OR GREAT 

GRANDPARENT, ETC. 



BROTHER: OF A SEGMENT. ANOTHER SEGMENT HAVING THE SAME PARENT 
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BRANCH (1): 



IN A DIRECTORY. A DATA STRUCTURE , CONTAINED IN A 
DIRECTORY SEGMENT, THAT DESCRIBES AN IMMEDIATELY 
-INFERIOR SEGMENT OR DIRECTORY (BUT NOT A. LINK) 



BRANCH (2): OF A DIRECTORY. REFERS TO THE ACTUAL SEGMENT OR 
DIRECTORY IMMEDIATELY INFERIOR TO THE DIRECTORY 



ENTRY (1).:. . DJ A DIRECTORY. SAME AS BRANCH (1) BUT INCLUDES LINKS 



ENTRY (2): OF A DIRECTORY. SAME AS BRANCH (2) BUT INCLUDES LINKS 



XYZ 



SEGMENT 


DIRECTORY 


LINK 


FILE 




BRANCH 


A BRANCH 


ENTRY 



STORAGE SYSTEM TERMINOLOGY 
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DIRECTORY SEGMENTS 




DIRECTORY SEGMENT STRUCTURE 
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DIRECTORY SEGMENTS 



a DIRECTORY SEGMENTS ARE DISK RESIDENT (RLV) DATA BASES MAINTAINED BY 
DIRECTORY CONTROL 



| ONE DIRECTORY SEGMENT PER DIRECTORY IN THE HIERARCHY 



B DIRECTORY SEGMENTS CONTAIN A CATALOG OF STORAGE SYSTEM INFORMATION 
■ " ABOUT "OTHER SEGMENTS, DIRECTORIES AND LINKS 



B ALL DIRECTORY' SEGMENTS , BY CONVENTION, RESIDE ON THE ROOT LOGICAL 
VOLUME (RLV) 



B DIRECTORY SEGMENTS ARE CREATED BY append MUCH LIKE NORMAL SEGMENTS 
ARE CREATED 



s DIRECTORY SEGMENTS CONTAIN MANY INTER-RELATED COMPLEX DATA 
STRUCTURES TO INCLUDE THE FOLLOWING (NOT NECESSARILY CONTIGUOUS) 
REGIONS: 



B DIRECTORY HEADER 

H CONTAINS SELF DESCRIPTIVE INFORMATION LIKE UID, AIM 
CLASSIFICATION, ETC; AND POINTERS TO OTHER REGIONS 
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DIRECTORY SEGMENTS 



1 HASH TABLE 

1 USED TO QUICKLY LOCATE AN ENTRY, GIVEN ITS NAME 

| ENTRY LIST 

8 CONTAINS ONE DESCRIPTIVE DATA STRUCTURE (AN ENTRY) FOR EACH 
SEGMENT, DIRECTORY, OR LINK. IMMEDIATELY INFERIOR TO THE 
DIRECTORY (I.E. ALL ENTRIES) 

| PERSON_ID AND PROJECTED NAME LISTS 

0 CONTAINS ALL PERSON_ID' S /PROJECTED' S REQUIRED TO DESCRIBE 
THE ACL, THE AUTHOR, ETC. OF ALL SEGMENTS AND DIRECTORIES 
IMMEDIATELY INFERIOR TO THE DIRECTORY (I.E. ALL BRANCHES) 

D NAME LIST (ONE PER ENTRY) 

J CONTAINS ALL NAMES CURRENTLY ASSIGNED TO THE ENTRY 

J PRIMARY NAME IS ACTUALLY CONTAINED IN ENTRY STRUCTURE 



S ACCESS CONTROL LIST (ONE PER ENTRY) 

1 CONTAINS ALL ACL ENTRIES CURRENTLY ASSOCIATED WITH THE ENTRY 



ITSELF 
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D I RECTORY CONTROL DATA BASES 



DIRECTORY HEADER 



'11111111112222212222333333 
0123A5S7390123-t56?890123I567S9 -3 123-15 



0 


PROCESS 10 QF'faAST-MOOlELES Cuff^Y tweJ^I^C 


1 


TYPE OF OBJECT (DIR HEADER « 3) 


SIZE OF HEADER (64 WORDS) 








6 WOROS USES BY SALVAGER FOR RECORDING 
DATE TIME CHECKED AND ERRORS DISCOVERED 








3 


DIRECTORY'S UNIQUE IDENTIFIER (UIOI 


* 


9 


DIRECTORY'S PHYSICAL VOLUME ID (PVIDI 


* 


10 


SONS' LOGICAL VOLUME ID (LVID) 


* 


11 


ACCESS ISOLATION MECHANISM (AIM! CLASS 


* 


12 










13 


DIRECTORY'S VTOCX * 


HEADER VERSION NUMBER 












14 


ENTRY LIST START R_PTR 






IS 


ENTRY LIST END R_PTR 


11 






16 


PERSONJD LIST START R_PTR 


PROJECTED LIST START R^PTH 


17 


PERSON.I0 LIST END R_PTR 


PROJECT JO LIST END R_PTR 


18 


NUMBER OF SEG ENTRIES 


Number of sir entries 


19 


NUMBER OF LINK ENTRIES 


NUMBER OF ACL ENTRIES 






9. 


u i * . a 




20 


ALLOCATION AREA R JTR 


E 






R 
9 


1 ! 9 | H t 

R 1 v 1 A f 









24 WORDS USED FOR INITIAL ACL IMPLEMENTATION 



45 
46 
4? 
48 
49 
50 

62 
S3 



HASH TA8LE SIZE 



HASH TABLE R PTR 



NUMBER OF USED PLACES IN HASH TABLE 



OEPTH OF THIS DIRECTORY 



DATE TIME SALVAGED <OTS) 



UID OF SUPERIOR MASTER DIR 



MODIFICATION PSEUDO-CLOCK 



12 WORDS UNUSED. 



CHECKSUM (NOT USEOI 



UID OF PARENT DIR 



(WORDS) 



DIRECTORY HEADER 



inci.oill 



A DISK RESIDENT (RLV - DIRECTORY SEGMENT) DATA BASE - ONE PER DIRECTORY 
'NOT WIRED. NOT ENCACHEABLE1 

'COPIED FROM BRANCH WHEN CREATED 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY HEADER 

B THE DIRECTORY HEADER IS A DISK RESIDENT DATA BASE CONTAINED AT THE 
BEGINNING OF A DIRECTORY SEGMENT 

0 ONE DIRECTORY HEADER PER DIRECTORY SEGMENT 



B THE DIRECTORY HEADER CONTAINS SELF DESCRIPTIVE INFORMATION SUCH AS: 



8 THE PROCESS ' ID OF^THE ' LAST PROCESS TO MODIFY THE DIRECTORY 
SEGMENT'S CONTENTS 



THE DIRECTORY'S UID, LVID, PVID, VTOC INDEX, AND AIM 
CLASSIFICATION 



RELATIVE POINTERS TO THE BEGINNING AND END OF THE ENTRY LIST, 
PERSON_ID LIST, PRO-JECT_ID LIST,- AND THE HASH TABLE 



D HIERARCHY DEPTH OF THE DIRECTORY SEGMENT 



| UID OF THE MASTER DIRECTORY AND THE PARENT DIRECTORY 



SON'S LVID - THE ID OF THE LV ON WHICH INFERIOR NON-DIRECTORY 
SEGMENTS RESIDE (AND WILL RESIDE) 



THE DIRECTORY HEADER IS ACCESSED AT THE BEGINNING OF DIRECTORY 
QUERY AND UPDATE OPERATIONS 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY ENTRIES 



1111111111222222222233 
Q1234S«7890123«S67SJ012345S?»901 



3 3 3 3 
2 3*5 



FORWARDS PTR 



BACKWARD R PTR 



TYPE OF ENTRY ISEG • 7) 



SIZE OF ENTRY (37 WORDS) 



ENTRY'S UNIQUE IDENTIFIER (UID) 



DATE TIME ENTRY MODIFIED (DTEM) 



. ' I N M, 



NUMBER OF NAMES 



NAME UST START R PTR 



NAME LIST END R PTR 



AUTHOR'S PERSON ID R PTR 



AUTHOR'S PROJECT IDR PTR 



AUTHOR'S TAG 



1* WORDS CONTAINING PRIMARY NAME 



22 
23 
2« 

25 
26 
27 
28 
29 
30 
31 



OATE TIME OUMPED (DTD) 



BRANCH'S PHYSICAL VOLUME ID (PVIO) 




ACCESS ISOLATION MECHANISM (AIM) CLASS 



R(1) I R(2) R(3) XR(1) XRIZI XR(3) 



ACL ENTRY COUNT 



ACL START R_PTR 



ACL END R_PTR 



BC AUTHOR'S PERSON JO RJTR 



3C AUTHOR'S PROJECTJO R_PTR 



: pip 

3C AUTHOR'S TAG ffl 



SIT COUNT (IF DIR. P 0 IMPLIES MSF> 



SONS* (NON-OIR*S) LOGICAL VOLUME ID (LVIOI 



34 



35 



CHECKSUM FROM DTD 



UIO OF PARENT DIRECTORY 



(WORDS) 



Idir_antrv.incj.pi1) 



BRANCH ENTRY 



A DISK RESIDENT (RLV - DIRECTORY SEGMENT) DATA BASE - ONE PER BRANCH IN DIRECTORY 
(NOT WIRED. NOT ENCACHEABLE) 
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DIRECTORY CONTROL DATA BASES 



DIRECTORY ENTRIES 





0 


1 2 3 4 S 6 7 8 


11111111 
90123*567 


112222222222333333 
8901234567B901234S 


0 




FORWARD R_ 


PTR 


BACKWARD R_PTR 


1 




TYPE OF ENTRY (LINK « SI 


SIZE OF ENTRY (69 WORDS) 


2 


LINK'S UNIQUE IDENTIFIER (UID) (NEVER VISIBLE TO USERS) 


3 


DATE TIME ENTRY MODIFIED (DTEM) 




B 








i 


R 

A 




I 


NUMBER OF NAMES 




N 


• 




5 




NAME LIST START R_PTR 


NAME LIST END R_PTR 


6 


AUTHOR'S PERSONJD R_PTR 


AUTHOR'S PROJECTJD R_PTR 


7 


AUTHOR'S TAG., 











14 WORDS CONTAINING PRIMARY NAME 



DATE TIME DUMPED (DTD) 



PATHNAME SIZE 



42 WORDS CONTAINING THE ABSOLUTE 
PATHNAME OF THE LINK'S TARGET 



UID CHECKSUM 



UID OF PARENT DIRECTORY 



I WORDS) 



(dir_lmk.mcf.Bl1i 



LINK ENTRY 



A DISK RESIOENT IRLV-DIRECTORY SEGMENT) DATA BASE - ONE PER LINK IN DIRECTORY 
(NOT WIRED. NOT ENCACHEABLE) 
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DIRECTORY CONTROL DATA BASES 



DIRECTORY ENTRIES 

B THE DIRECTORY ENTRY IS A DISK RESIDENT (RLV) DATA BASE CONTAINED 
WITHIN A DIRECTORY SEGMENT 

J ONE DIRECTORY ENTRY (IN THE DIRECTORY SEGMENT) FOR EACH 
IMMEDIATELY INFERIOR ENTRY IN THE HIERARCHY 

a EACH DIRECTORY ENTRY IsTa DATA STRUCTURE DESCRIBING THE ATTRIBUTES 
. OF A SEGMENT , DIRECTORY OR -LI NK 

a DIRECTORY ENTRIES COME IN TWO FLAVORS: 

I LINK ENTRY, (38 OR 72 WORDS) CONTAINING: 

] DATE TIME MODIFIED AND DUMPED (BY THE HIERARCHY DUMPER, NOT 
VOLUME DUMPER) 

0 RELATIVE POINTERS TO THE ENTRY'S NAME LIST AND AUTHOR'S USER 
ID 

jj ABSOLUTE PATHNAME OF THE LINK'S TARGET 
8 UID OF PARENT DIRECTORY 
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DIRECTORY CONTROL DATA BASES 
DIRECTORY ENTRIES 

B BRANCH ENTRY , (38 WORDS) CONTAINING: 

J DATE TIME MODIFIED AND DUMPED (BY THE HIERARCHY DUMPER, NOT 
VOLUME DUMPER) 

I RELATIVE POINTERS TO THE ENTRY'S NAME LIST AND AUTHOR'S USER 
ID 

8 BRANCH'S UID, PVID, AND VTOC INDEX 

5 AIM CLASSIFICATION, ENTRY POINT BOUND, RING BRACKETS, AND 
RELATIVE POINTERS TO THE ACL 

| BRANCH'S BIT COUNT AND BIT COUNT AUTHOR 

| SON'S LVID (IF A DIRECTORY) AND PARENT'S UID 

D FLAGS DESCRIBING VARIOUS STATES AND PROPERTIES OF THE ENTRY 
SUCH AS: DIRECTORY, MASTER DIRECTORY, SECURITY OUT OF 
SERVICE,. COPY AND SAFETY SWITCH. ETC 
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DIRECTORY CONTROL COMMANDS 



d i spl ay branch 

a D I SPLAY_BRANCH - DISPLAYS BRANCHES IN THE DIRECTORY HIERARCHY 

I OFTEN USEFUL ON CONJUNCTION WltH DUMPJ/TOCE Q \ J| Co^k^aJ 

! d i spl ay_branch >udd>rtu 1 t i cs>S i bert 

Branch for Si bert in >udd>Mul tics at 245 1 20742 



UID 1 0240 11 70050. is vtocx 63 on root4 (of log vol. root) 
Sibert is a directory. "~. 
Ring brackets (0 0 0) 

Entry modified 02/23/83 1912.1 est Wed 
Dumped 03/20/83 0955-6 est Sun 
9 names. 



a DISPLAY IS NOT COMPLETE, SO A R ! NG_ZER0_DUKP OF THE SAME DATA IS 
INCLUDED " r . 

CUV > 



! r i ng_zero_dump >udd>rtu 1 t i cs 20742 46 -ch 

^ > aoi^Y 

020742 021310020604 000004000046 U0240 1170050 446556324757 SB.x 

020746 400000000011 020752021152 001720000532 172000000000 j 2 

020752 021010000000 000006000016 020742000233 000000000000 

020756 1231511.42145 162164040040 040040040040 040040040040 Sibert 

020762 040040040040 040040040040 040040040040 040040040040 

020766 000000000000 102401170050 446752147026 000000000000 B.x(..g. 

020772 135240026001 000063000000 400000000000 000000000000 ] 3 

020776 000000000000 000770000012 021170021300 001720000532 x... 

021002 172000000000 225072707470 000000000000 000000000000 z : 

021006 033023254650 000000000000 
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VOLUME MANAGEMENT OVERVIEW 



a FUNCTION 

g VOLUME MANAGEMENT IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
AND LOGICAL VOLUMES 

1 ITS TASKS INCLUDE: 

| ACCEPTANCE AND DEMOUNTING OF PHYSICAL VOLUMES 

| . MAINTAINING THE. ASSOCIATION BETWEEN PHYSICAL VOLUMES, LOGICAL. 
VOLUMES, AND DISK DRIVES "*~ • ' 

§ : ENSURING THE INTEGRITY OF VOLUME CONTENTS 

I MAKING VOLUME CONTENTS ACCESSABLE TO PAGE CONTROL (PAGES) AND 
SEGMENT CONTROL (VTOC ENTRIES) 

0 VOLUME MANAGEMENT IS INVOKED ONLY BY SUBROUTINE CALLS 
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VOLUME MANAGEMENT OVERVIEW 



s> MAJOR DATA BASES 



I PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 

B PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE KNOWN 
TO THE SYSTEM 



EACH PVTE IDENTIFIES A DRIVE'S DEVICE NUMBER, SUBSYSTEM NAME, 
DEVICE TYPE, AND INFORMATION ABOUT THE PHYSICAL VOLUME 
CURRENTLY MOUNTED 



| USED TO MAP REFERENCES TO' PAGES OF SEGMENTS INTO AN I/O 
REQUEST TO THE CORRECT DISK DRIVE 



I LOGICAL VOLUME TABLE (LVT) - ONE PER SYSTEM 

1 LOGICAL VOLUME TABLE ENTRY (LVTE) - ONE PER MOUNTED LOGICAL 
VOLUME 



0 EACH LVTE CONTAINS THE LOGICAL VOLUME ID, POINTERS TO MEMBER 
PVTE'S, AIM CLASS LIMITS, ETC. 

0 USED TO DETERMINE A USER'S ACCESS TO A LOGICAL VOLUME 
(PRIVATE OR PUBLIC) AND TO LOCATE MEMBER PHYSICAL VOLUMES 



fl VOLUME HEADER - ONE PER PACK 

| VOLUME LABEL (REGISTRATION AND ACCEPTANCE INFORMATION) 

jj VOLUME MAP (OCCUPIED/VACANT INFORMATION FOR VOLUME CONTENTS) 
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VOLUME MANAGEMENT OVERVIEW 



I RECORD STOCKS - ONE PER MOUNTED VOLUME 

J ONLINE CACHE OF INFORMATION ABOUT USED / UNUSED RECORDS ON 

THE VOLUME 



8 THIS INFORMATION IS DERIVED FROM THE VOLUME MAP, BUT KEPT 
ONLINE TO AVOID THE NECESSITY OF REFERRING TO THE VOLUME MAP 
ON DISK EVERY TIME A RECORD IS ALLOCATED OR FREED 



| WHEN THE CACHE BECOMES COMPLETELY EMPTY OR COMPLETELY FULL, 
.IT MUST BE UPDATED FROM/TO DISK - A PROTOCOL ENSURES THAT THE 
COPY ON DISK IS ALWAYS CONSISTENT 



J} PROVIDED BY VOLUME MANAGEMENT, BUT USED BY PAGE CONTROL 



J VTOCE STOCKS - ONE PER VOLUME 

USED / UNUSED VTOC ENTRIES ON THE VOLUME 
I PROVIDED BY VOLUME MANAGEMENT, BUT USED BY SEGMENT CONTROL 



1 PHYSICAL VOLUME HOLD TABLE (PVHT) - ONE PER SYSTEM 

| RECORDS THE COMMENCEMENT OF COMPOUND I/O OPERATIONS UPON A 
PHYSICAL VOLUME 



8 THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE 
SUCH AN OPERATION IS IN PROGRESS 
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THE NEW STORAGE SYSTEM 



» / 

(0 r 



PVrpv 



LOGICAL VOLUME A 



PV root 2 



LOGICAL VOLUME B 



PV root 3 



HEADER 



VTOC 



PAGING 
REGION 



PARTITION 




LOW PARTITION 



HIGH PARTITION 



PVpub01 



HEADER 



VTOC 



PAGING 
REGION 



PV pub 02 



HEADER 



VTOC 



PAGING 
REGION 



PHYSICAL VOLUME (PV): 
LOGICAL VOLUME (LV): 

VOLUME HEADER: 

VOLUME TABLE OF CONTENTS (VTOC): 
PAGING REGION: 

PARTITION: 



A DISK PACK 

A COLLECTION OF ONE OR MORE PHYSICAL 
VOLUMES GIVEN A SINGLE LQGICAL IDENTITY 

CONTAINS THE LABEL, VOLUME MAP, VTOC 
MAP, AND VOLUME DUMP MAPS. 

AN ARRAY OF ENTRIES (VTOCE's) DESCRIBING 
EACH SEGMENT ON THE PHYSICAL VOLUME 

THE REGION IN WHICH ALL RECORDS DESCRIBED 
IN THE VTOC RESIDE (I.E.. PAGES OF STORAGE 
SYSTEM SEGMENTS) 

A REGION SET ASIDE FOR SOME PURPOSE OTHER 
THAN PAGES OF STORAGE SYSTEM SEGMENTS 



\x 

O 

3 

Q 
W 

in 

in 



THE NEW STORAGE SYSTEM 



SINCE RELEASE 4.0, THE MULTICS STORAGE SYSTEM HAS BEEN ORGANIZED 
INTO PHYSICAL AND LOGICAL VOLUMES HAVING THE FOLLOWING PROPERTIES 

1 4U/^'t Wt le^oo\> 



8 A PHYSICAL VOLUME (PV) IS A DISK PACK (MOUNTED OR NOT) 
CONTAINING: 



0 A LABEL IDENTIFYING ITSELF - INCLUDING A PHYSICAL VOLUME ID 
(PVID) 



| A VOLUME MAP DESCRIBING WHICH PAGES and VTOCES ARE IN USE, AND 
WHICH ARE FREE. 



8 A VOLUME TABLE OF CONTENTS (VTOC) DESCRIBING WHICH SEGMENTS 
ARE RESIDENT THEREIN - AND THE EXACT LOCATION OF EACH OF 
THEIR PAGES 



8 THE PAGES OF RESIDENT SEGMENTS {ASSIGNED TO RECORDS OF 1024 
WORDS IN SIZE) 



8 AND OPTIONALLY: CONTIGUOUS REGIONS CALLED PARTITIONS, SET 
ASIDE FOR SPECIAL USE (FDUMP IMAGES, HARDCORE PAGING, ETC) 



0 ALL PAGES OF A SEGMENT RESIDE ON A GIVEN PHYSICAL VOLUME 



8 THAT IS: EACH NON-ZERO PAGE OF A SEGMENT IS ASSIGNED TO A 
RECORD OF THE PHYSICAL VOLUME 



8 THE PAIR OF PHYSICAL VOLUME ID (PVID) AND VTOC INDEX UNIQUELY 
IDENTIFIES ANY SEGMENT IN THE STORAGE SYSTEM HIERARCHY 
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THE NEW STORAGE SYSTEM 



A LOGICAL VOLUME <LV) CONSISTS OF ONE OR MORE PHYSICAL VOLUMES, 
WHICH ARE: 



| GIVEN ONE LOGICAL VOLUME ID (LVID) 
| ALWAYS MOUNTED AS A SET 



OFFSPRING (SONS, GRANDSONS, ETC) OF A DIRECTORY (NORMALLY) 
RESIDE WITHIN A GIVEN LOGICAL VOLUME 



1 IN OTHER WORDS, A SUB-TREE (NORMALLY) SPANS NO MORE THAN ONE 
LOGICAL VOLUME - 



DIRECTORY SEGMENTS ARE AN EXCEPTION TO THE ABOVE AS ALL 
DIRECTORY SEGMENTS ARE ASSIGNED TO A LOGICAL VOLUME OF THEIR OWN 
CALLED THE "ROOT LOGICAL VOLUME" (RLV) 



B THE PHYSICAL VOLUME CONTAINING THE ROOT DIRECTORY IS CALLED 
"THE ROOT PHYSICAL VOLUME" (RPV) 

| THE RLV IS SPECIAL BECAUSE IT MUST ALWAYS BE MOUNTED, AND IT 
CONTALNS. ALL DIRECTORY SEGMENTS , BUT IT ALSO CONTAINS OTHER 
SEGMENTS 



SHOULD THE GROWING OF A SEGMENT CAUSE A PHYSICAL VOLUME TO 
BECOME FULL, A "SEGMENT MOVE" IS AUTOMATICALLY INITIATED 

1 THIS IS ONE OF THE MOST COMPLEX AND EXPENSIVE SERVICES 
PERFORMED BY THE SYSTEM - BUT HAPPENS VERY INFREQUENTLY 
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THE NEW STORAGE SYSTEM 



§ SHOULD A LOGICAL VOLUME BECOME FULL: 



J USER. AND SYSTEM ERROR MESSAGES ARE GENERATED 



8 SPACE MUST BE OBTAINED ON THE LOGICAL VOLUME BY ADDING MORE 
PHYSICAL VOLUMES OR BY DELETING OR MOVING SEGMENTS FROM THE 
LOGICAL VOLUME 



I BECAUSE IT CONTAINS ALL DIRECTORY SEGMENTS, SPACE ON THE RLV 
IS CRITICAL: IF IT IS USED UP, THE SYSTEM MAY NOT BE ABLE TO 
CONTINUE OPERATION,--: 



THE CHOICE OF WHICH PHYSICAL VOLUME TO USE WHEN CREATING A 
SEGMENT IS MADE IN SUCH A WAY AS TO TRY TO BALANCE THE ALLOCATED 
SPACE ON ALL THE PHYSICAL VOLUMES OF A LOGICAL VOLUME 



Tfc- 



C -PCN ±^ 




C Ovate f flifT 



Vol ^V7<3<X 




W 




vipa 



v vToc tk \ 



IT 



ft 
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THE NEW STORAGE SYSTEM 



yvpc w 



VOLUME LABEL 
(REGISTRATION INFORMATION) 



VOLUME MAP 
(USED RECORDS MAP) 



VTOC HEADER AND 
DUMPER BIT MAP 







1 





VTOCE's 

(ONE PER RESIDENT SEGMENT: ~ 15,000 VTOCE'S) 



111 fir 
SO 
Oiu 



o 





(FIVE PER RECORD: « 3,000 RECORDS) 


. 4 










PAGES OF SEGMENTS 





(ONE PER RECORD: « 35,000 RECORDS) 



* S2 

<UJ 
O.S 



38,247 



PARTITIONS (IF ANY) 
(SPECIAL-USE REGIONS . . . SUCH AS FDUMP IMAGES) ^ 



Z 

o 



CC 

< 

0. 



(RECORDS) (disk_pack.incl.pl1) 

PHYSICAL VOLUME FORMAT 

(MSU451) 
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THE NEW STORAGE SYSTEM 



HIERARCHY TO STORAGE SYSTEM 
MAPPING 



VTOCS 2r 
VTOCE 2 
VTOCE . 3 

vtoce 4 

VTOCE I*.' 
VTOCE 6 
VTOCE 1 
JVTOCE 



PV14 




HEADER INFO 


> 


file map 


udd 


file map 


sel ... 


file map 


Proj^A 


file map 


•. tools . 


v file-map. . • 


JOfMS 


file map 


' -toots ■ 


' - '- file map - 


Smith 


fila map .. 










fa 




VTOC* 




udd 
idd 
sel 


d 
d 
d 


14 

14 
14 


2 
12 
3 


T\ 
dtr 








J 












MED 
Pubs 


d 
d 
d 


14 
14 

17 


16 
4 

10 


t 

udd 














i 






Smith 
Jones 
May 
Proj_A 


d 
d 
d 

s 


14 
14 

17 
29 


8 
6 
3 
3 


dir / 

u 




















Sfnrth.mox 

tools 

test 


s 
d 
s 


29 
14 
29 


8 Z 
41 
4 


Smith 

T 



PHYSICAL VOLUME ID 14 
CONTENTS (SIMPLIFIED! 





PV29 






HEADER INFO 


1 


my_seg 


file map 


2 


start_up.ec 


file map 


3 


ProL»A 


file map 


4 


test 


file map 


s ■ 


' «"9-V • 


file map 


6 


Smith.mbx 


file map 









t 

VOLUME 
HEADER 



roc 




i<Ww A/L/U w>i^_a. 



my_fq 




PHYSICAL VOLUME ID 29 
CONTENTS SIMPLIFIED) 



Not To Be Reproduced 



6-9 



THE NEW STORAGE SYSTEM 



B IF ONE KNOWS WHERE THE ROOT DIRECTORY IS, ALL SEGMENTS IN THE 
MULTICS HIERARCHY CAN BE FOUND (ASSUMING THE AVAILABILITY OF ALL 
REQUIRED. PHYSICAL VOLUMES) 



B MAJOR DESIGN POINT 



fl MANY DISK RESIDENT DATA BASES (TO INCLUDE THE PAGES OF SEGMENTS) 
ARE COPIED INTO MAIN MEMORY AND WRITTEN BACK TO DISK AT SUCH 
TIMES AS : ' 



i SYSTEM START-UP/SHUT-DOWN 
i PHYSICAL VOLUME MOUNTING /DEMOUNTING 
1 SEGMENT ACTI VATI ON /DEACTI VATI ON 
• J PAGE FAULTS 

8 WHILE IN MAIN MEMORY, THE MEMORY RESIDENT COPY 'IS CONSIDERED TO 
BE THE COPY 

J WHILE IN MAIN MEMORY, THE DISK RESIDENT COPY IS CONSIDERED TO BE 
(AND OFTEN IS) WHOLLY INVALID 
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THE NEW STORAGE SYSTEM 





SECTOR 


VTOCE 


RECORD 
(PAGE) 


TRACK 


CYLINDER 


PACK 


WORDS 


64 


192 


1024 


3072 


58,368 


39.2M 


SECTORS 




■ • 3' 


16 


40 


752 


611.9K 


VTOCES 






5 








RECORDS 
(PAGES) 








2.5 


47 


38,247 


TRACKS 










19 




CYLINDERS 












815 



MULTICS DISK PACK STATISTICS (MSU 451) 



* THE ABOVE FIGURES APPEAR INCONSISTENT IF 
DATA FORMATTING IS NOT CONSIDERED 
(E.G.: SOME DISK SPACE IS NOT USED) 
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r 



5 



ft 

















H T 

L_^* t-OQICAL VOLUME C) | 

in 



5 

II 



6 



5 



46 

s 1 ! 

6 



'5 



LOGICAL VOLUME 



ME_ _ I 



6 



6 



LOGICAL VOLUME 



6 



L 



6 6 

LOGICAL VOLUME 



LOGICAL VOLUME/MASTER DIRECTORY RELATIONSHIP 

• NOTE: ALL DIRECTORY SEGMENTS RESIDE ON ONE DESIGNATED 

LOGICAL VOL UME CALLED THE ROOT LOGICAL VOLUME (RLVJ 



VOLUME MANAGEMENT TERMINOLOGY 



MOUNT: 



TO PHYSICALLY PLACE A DISK PACK ON A DRIVE AND CYCLE UP 
THE DRIVE. (PERFORMED BY THE OPERATOR, NOT BY 
SOFTWARE) 



ACCEPT: 



AFTER MOUNTING, TO ESTABLISH IN THE SUPERVISOR THE 
BINDING BETWEEN THE DRIVE AND THE PHYSICAL VOLUME 
MOUNTED 



PUBLIC i 



A LOGICAL VOLUME ATTRIBUTE I NDI CATI NG THAT THE VOLUME 
IS ATTACHED TO ALL PROCESSES (BY DEFAULT) WHEN ACCEPTED 



PRIVATE: 



A LOGICAL VOLUME ATTRIBUTE INDICATING THAT THE VOLUME 
IS ATTACHED ONLY TO REQUESTING PROCESSES (SUBJECT TO 
ACCESS CONTROLS) 



PARTITION: A REGION WITHIN A PHYSICAL VOLUME SET ASIDE FOR SPECIAL 

USE 



RECORD: 



A LOGICAL UNIT OF DISK SPACE, 1024 CONTIGUOUS. WORDS IN 
SIZE... (NUMBERED/ADDRESSED FROM ZERO) 



SECTOR: 



A LOGICAL UNIT OF DISK SPACE, 64 CONTIGUOUS WORDS IN 
SIZE. THE-_SMALLEST_ADjBRES SABLE UNIT OF DISK SPACE. A 
RECORD CONTAINS 16 SECTOl 
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VOLUME MANAGEMENT TERMINOLOGY 



PAGE: A 1024 WORD EXTENT OF DATA STARTING AT A 1024 WORD 

BOUNDARY OF A SEGMENT. SEGMENTS MUST BE AN INTEGER 
NUMBER OF PAGES IN SIZE. A PAGE CAN RESIDE IN ONE OR 
MORE OF THE FOLLOWING LOCATIONS: 



MAIN MEMORY FRAME 
DISK RECORD 
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VOLUME MANAGEMENT DATA BASES 
VOLUME LABEL 



11111111 112222222222333333 
01234587S901234SC7S901234S67S9012345 



0-0 



4- 63 

5- 0 



320 WORDS (5 SECTORS) NOT USED (GCOS LABEL REGION) 



8 WORDS: "Muttks Storags Syttam Volumt" 



VERSION NUMBER 



9 WORDS CONTAINING MANUFACTURE'S SERIAL NUMBER 
8 WORDS CONTAINING PHYSICAL VOLUME NAME 
8 WORDS CONTAINING LOGICAL VOLUME NAME 



33 
34 
35 
38 
37 
38 
39 
40 
41 
42 
43 



PHYSICAL VOLUME IDENTIFIER (PVID! 



LOGICAL VOLUME IDENTIFIER (LVID) 



PVID OF THE ROOT PHYSICAL VOLUME 



TIME REGISTERED 



■ - ■ 



. n .... I , I ,,,. „ , I „ , II „ I m i . m . j I . . . .. 



VOLUME SIZE (NO. RECORDS) 



lllisiiiiiiiiiiiiii 



VTOC SIZE (NO. RECORDS) 













111! 








iiliiiili 

























MAXIMUM AIM CLASSIFICATION IN VOLUME 



MINIMUM AIM CLASSIFICATION IN VOLUME 



O o 
Off 



18 WORDS NOT USED 



6-0 
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VOLUME MANAGEMENT DATA BASES 



VOLUME LABEL 



6-0 
6-1 

6-2 
6-4 

6-6 



7-0 
7-1 
7-2 
7-3 
7-4 
7-5 

7-7 

7-8 

7-9 

7-10 

7-11 

7-12 

7-13 



VOLMAP VERSION (OVERLAYS OLD TIME— UNMOUNTED) 



— 



H£3£ ,,,..,. ,,„,„.„, : 



TIME SALVAGED 



TIME OF BOOTLOAO 



TIME UNMOUNTED 



8 WORDS USED BY VOLUME DUMPER 
48 WORDS UNUSED 



VTOC INDEX OF 



23 



DIRECTORY 



SHUTDOWN STATE 



DISK_TABLE_ VTOC INDEX 



OISK.TABLE. UNIQUE ID 



ESC STATE 



VOLUME MAP ORIGIN RECORD 



VOLUME MAP SIZE 



VTOC MAP ORIGIN RECORD 



VTOC MAP SIZE 1 



VOLUME MAP SECTION SIZE 



VTOC ORIGIN RECORD 



DUMPER BIT MAP RECORD 



VOLUME INCONSISTENCY COUNT 



52 WORDS UNUSED 



8-3 
4 

5 
6 
7 







! 1 _ ' 11 1 • 


NUMBER OF PARTITIONS 


PARTITION (11 NAME 








J PARTITION (1) LOCATION 




| PARTITION 11) SIZE 



15 - 63 Q 



(SECTOR-WORD) 



2 

a. 

z < 
< 



188 WORDS DESCRIBING PARTITIONS 2 THRU 47 



320 WORDS (5 SECTORS) NOT USED 



(fs.wM_labtl.incJ.pl1) 



VOLUME LABEL 

A DISK RESIDENT DATA BASE - ONE PER PHYSICAL VOLUME 
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VOLUME LABEL 



8 THE VOLUME LABEL IS A DISK RESIDENT DATA BASE OCCUPYING THE FIRST 
MULTICS RECORD OF EACH STORAGE SYSTEM PHYSICAL VOLUME 



| ONE VOLUME LABEL PER PHYSICAL VOLUME 



.8 THE LABEL IS GENERATED BY init_disk_pack ( init_empty_root IF RPV 
LABEL) AND CONTAINS, REGISTRATION AND STATUS INFORMATION 



8 THE LABEL IS INSPECTED WHEN THE VOLUME IS ACCEPTED AND UPDATED WHEN 
DEMOUNTED 

8 THE LABEL IS DIVIDED- INTO SIS SECTORS 

J GCOS REGION (SECTORS 0 TO 4) 

1 SKIPPED OVER BY MULTICS TO AVOID ACCIDENTAL OVERWRITING OF 
GCOS PACKS AND ALLOW FOR FUTURE C0MPATA3ILITY 

fl PERMANENT REGION (SECTOR 5) 

0 CONTAINS PERMANENT PER-PV INFORMATION (EG: MANUFACTURERS 
SERIAL NUMBER) 
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VOLUME MANAGEMENT DATA BASES 
VOLUME LABEL 



jj DYNAMIC INFORMATION REGION (SECTOR 6) 

g CONTAINS INFORMATION RELATING TO THE MOST RECENT MOUNTING OF 
THE PV (EG: LAST MOUNT TIME) 

0 ALLOWS THE STORAGE SYSTEM TO ENSURE THE INTEGRITY OF THE PV 



| ROOT INFORMATION REGION (SECTOR 7) 

| . DEFINED ONLY FOR THE ROOT PHYSICAL VOLUME. 

fl CONTAINS DYNAMIC INFORMATION ABOUT THE ENTIRE STORAGE SYSTEM 
(EG:- SHUT DOWN STATE, PAGING DEVICE STATE, ETC) ■ 

D PARTITION MAP (SECTOR 8) 

1 IDENTIFIES THE LOCATION AND LENGTH OF ANY RESIDENT PARTITIONS 

D UNUSED (SECTORS 9 TO 13) 
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VOLUME MANAGEMENT DATA BASES 



VOLUME MAP 



11111111112222222222333333 
012345678901234567890123456789012345 



16-0 



SIZE OF PAGING REGION 


■-■ - ' v v 


LOCATION OF PAGING REGION 


■V ■ ■"• ■ • . IBI 


Hi ^ ■■ ■ : - 


NUMBER OF VACANT RECORDS 




SIZEOFBITMAP 






- «... Km,,. : r;;,;'^ J '.im^;^,,;! ^'..Im .,; i 



60 WORDS NOT USED 



17-0 
1 



V 


i • «— "\ .,„.. 

BIT MAP OF FIRST 32 RECORDS 1 


. i 




BIT MAP OF SECOND 32 RECORDS 






BIT MAP O F 3008th 32 R ECORDS 

1 • L 



(SECTOR - WORD) <fc_vol._map.ind.pl1) 



VOLUME MAP 

A DISK RESIDENT DATA BASE - ONE PER PHYSICAL VOLUME 
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VOLUME MAP 



B THE VOLUME MAP IS A DISK RESIDENT DATA BASE 



1 OCCUPIES RECORDS 1, 2, AND 3, IMMEDIATELY FOLLOWING THE VOLUME 
LABEL 



1 ONE VOLUME MAP PER PHYSICAL VOLUME 



THE VOLUME MAP IDENTIFIES THE EXTENT OF THE PAGING REGION, THE 
NUMBER OF VACANT RECORDS, AND THE STATE (VACANT/OCCUPIED) OF EVERY 
RECORD IN THE VOLUME'S PAGING REGION 



i THIS INFORMATION IS ALSO DERIVABLE FROM AN ANALYSIS OF THE VTOC 
(AT CONSIDERABLE EXPENSE) - THIS IS DONE WHEN THE VOLUME IS 
SCAVENGED OR SALVAGED. 



RECORDS ARE TAKEN FROM THE VOLUME MAP DURING OPERATION AND PLACED 
IN THE RECORD STOCK 



J RECORDS ARE ALLOCATED BY PAGE CONTROL FROM THE RECORD STOCK 



1 VOLUME MAP ON DISK IS ALWAYS CONSISTENT 

8 RECORDS MARKED FREE ON DISK ARE GUARANTEED TO BE FREE, AND 
SAFE TO RE-USE 



Not To Be Reproduced 
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VOLUME MANAGEMENT DATA BASES 



VOLUME MAP 

0 RECORDS MARKED AS. ALLOCATED MAY NOT ACTUALLY BE IN-USE, IF A 
CRASH OCCURRED AND DESTROYED THE STOCK CONTENTS 

0 THIS SITUATION IS BENIGN, AND CORRECTED BY A. SCAVENGE OR 
SALVAGE AT SOME CONVENIENT TIME 



J RECORDS FREED ARE PLACED BACK IN THE STOCK 

1 IF STOCK FILLS, IT IS WRITTEN BACK TO THE VOLUME MAP 

0 CONSISTENCY IS ENSURED BY COMPLEX PROTOCOL IN PAGE CONTROL 

I' RECORD STOCK MECHANISM REPLACES FSMAP SEGMENTS IN PRE-MR10.0 
SYSTEMS 



Not To Be Reproduced 
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DUMPER BIT MAP 



NUMBER OF VTOCES 



NUMBER OF FREE VTOCES 



NUMBER OF WORDS USED IN BIT MAP 



NUMBER OF LAST RECORD IN VTOC 



4 WORDS UNUSED 

> — - ■ . — — \ 



VTOC BIT MAP ENTRY 0 



1023 



VTOC BIT MAP ENTRY 1015 



VOLUME DUMPER BIT MAP 
RECORDS 4 AND 5 



8 WORDS UNUSED 

\_— s. 



VOLUME DUMPER BIT MAP ENTRY 0 



2047 



VOLUME DUMPER BIT MAP ENTRY 2039 



VTOC MAP 

RECORD 6 
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VOLUME MANAGEMENT DATA BASES 



DUMPER BIT MAP 



fi THE DUMPER BIT MAP DESCRIBES WHICH VTOCES ON THE VOLUME HAVE BEEN 
VOLUME DUMPED 



I ONE PER PHYSICAL VOLUME 



8 OCCUPIES RECORDS 4 AND 5, IMMEDIATELY FOLLOWING VOLUME MAP 



|. SEPARATE BIT MAPS FOR INCREMENTAL AND CONSOLIDATED VOLUME DUMPS 
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VOLUME MANAGEMENT DATA BASES 



VTOC MAP 



THE VTOC MAP DESCRIBES THE LOCATION AND SIZE OF THE VTOC, AND 
CONTAINS A BIT MAP OF VTOC ALLOCATIONS 



1 OCCUPIES RECORD 6, IMMEDIATELY FOLLOWING THE DUMPER BIT MAP 
g VTOC FOLLOWS, STARTING AT RECORD 8 
1 RECORD 7 IS UNUSED 



s VTOCES ARE TAKEN FROM THE VTOCE MAP AND PLACED IN AN ONLINE STOCK 

| VTOCE STOCK IS LIKE RECORD STOCK, BUT LESS CRITICAL 

1 VTOCES ARE SELF- IDENTIFYING AS TO WHETHER THEY ARE IN USE OR 
NOT, SO IT IS NOT NECESSARY TO MAINTAIN PERFECT CONSISTENCY 
IF A CRASH OCCURS 

1 VTOCE MAP IS ALSO REBUILT BY SCAVENGE OR SALVAGE OPERATIONS 
1 VTOCE MAP REPLACES VTOCE FREE LIST IN PRE-MR10.0 SYSTEMS 
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•to 

19 



40 



4 
5 
6 
7 
8 

9 
10 
11 



NUMBER OF ENTRIES 



MAXIMUM NUMBER OF ENTRIES 



NUMBER OF ENTRIES IN USE 




9 WORDS OF INFORMATION ABOUT RFV AND RLV 



21 WORDS OF GLOBAL INFORMATION AND 
METERING CELLS FOR VOLUME MAPS 
AND VTOC MAPS 



ARRAY OF PHYSICAL VOLUME TABLE ENTRIES 

PHYSICAL VOLUME TABLE ENTRY (PVTE) 
ONE PER PHYSICAL VOLUME 
LOCATED IN PHYSICAL VOLUME TABLE 



0 


M4VS1CAL VOLUMf 1© 


1. 


LOGICAL VOLUME 10 




D 


0 


0 








2 


i 

U 


1 

u 


1 

u 




SKIPPED FOR PDIR ALLOCATION 


J NEXTPVINLV 



DISK SUBSYSTEM NAME 



w 4m. 



DISK DRIVE TYPE 



DISK DRIVE NUMBER 



FREE VTOCE COUNT 



INC. OUMPER BIT MAP POINTER 



FREE RECORO COUNT 



s 


p 


t la 


3 


C 


0 


fl 


s 


V 


3 




V 


H 


V 


s 


£ 


E M 


0 


R 


1 


P 


c 


0 


0 




A 


c 


1. 




R 


S 


M 






V 


A 


L 


M 




C 


u 


n 




M 


T 1 










V 


M 


Z 











V I V 

iii I 



VTOCSC2E [IN RECORDS) 



CONS. DUMPER BIT MAP POINTER 



TOTAL RECORO COUNT 



DISK DIM INFORMATION 



inc. Dumper vtoc index 



CONS. OUMPER VTOC INDEX 



COMP. OUMPER VTOC INDEX 



TOTAL VTOCS COUNT 



FIRST RECORO IN PAGING REGION 































Mi 























9 WORDS FOR VOLUME MAP AND VTOC MAP INFORMATION 



I ■ v ■ s , 


j VOLUME TROUBLE COUNT 


SCAVENGER INFO POINTER 
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VOLUME MANAGEMENT DATA BASES 



PHYSICAL VOLUME TABLE (PVT) 



THE PHYSICAL VOLUME TABLE (PVT) IS A HARDCORE, WIRED, PAGED DATA 
BASE MAINTAINED BY VOLUME MANAGEMENT 



D ONE PVT PER SYSTEM 



B THE PVT IS THE MOST IMPORTANT DATA BASE OF VOLUME MANAGEMENT, AND 
CONTAINS AN ARRAY OF PHYSICAL VOLUME TABLE ENTRIES (PVTE'S) 



| ONE PVTE PER DISK DRIVE KNOWN TO THE SYSTEM 



a EACH PVTE DESCRIBES: 



II A DISK DRIVE CONFIGURED TO THE SYSTEM 



| INCLUDING THE DEVICE NUMBER, DEVICE TYPE, SUBSYSTEM NAME AND 
OTHER INFORMATION NEEDED BY THE DISK DIM 



THE PHYSICAL VOLUME CURRENTLY MOUNTED ON THE DISK DRIVE 



INCLUDING THE PVID, LVID, AND OTHER INFORMATION TAKEN FROM 
THE VOLUME HEADER,. VOLUME MAP AND VTOC MAP, NEEDED BY PAGE 
AND SEGMENT CONTROL (THE PV & LV NAMES ARE NOT RECORDED HERE) 



RECORD AND VTOCE STOCKS ARE LOCATED FROM THE PVT, BUT KEPT IN 
THE stock_seg 
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LOGICAL VOLUME TABLE (LVT) 



111111111122222 2 2222333333 
012345S78901 2 34SI7S90123«SC7890123«5 











MAX LVTE INOEX 


":■ ■ - :" : v.. .. ,.. 




HIGH WATER LVTE INOEX 










FIRST FREE LVTE POINTER 







4 WORDS NOT USED 



84. WORDS OF LVTE POINTERS USED 
AS A HASH TABLE 



POINTER TO NEXT LVTE 



FIRST PVTER PTR 



lillliiiiiiii 



LOGICAL VOLUME ID (LVID) 



MINIMUM AIM CLASSIFICATION 
IN LOGICAL VOLUME 



MAXIMUM AIM CLASSIFICATION 
IN LOGICAL VOLUME 



pTTI 
bT 



K£. 



ALLOCATION ALGORITHM VALUE 



OTHER LVTE's 
ONE PER MOUNTED LOGICAL VOLUME 



(WORDS) 



(Iw. mcLpn) 



LOGICAL VOLUME TABLE (LVT) 

A HARDCORE DATA BASE - ONE PER SYSTEM 



LOGICAL VOLUME TABLE ENTRY (LVTE) 

ONE PER MOUNTED LOGICAL VOLUME 
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LOGICAL VOLUME TABLE (LVT) 



THE LOGICAL VOLUME TABLE (LVT) IS A HARDCORE, PAGED DATA BASE 
MAINTAINED BY VOLUME CONTROL 



D ONE LVT PER SYSTEM 



s THE LVT CONTAINS AN ARRAY OF LOGICAL VOLUME TABLE ENTRIES (LVTE'S) 



| ONE LVTE FOR EACH ; MOUNTED LOGICAL VOLUME 



5 EACH LVTE DESCRIBES THE LOGICAL VOLUME TO INCLUDE: 



D LVID AND AIM CLASSIFICATION 



RELATIVE POINTER TO THE THREAD OF PVTE'S OF ACCEPTED PHYSICAL 
VOLUMES THAT ARE MEMBERS OF THE LOGICAL VOLUME 



Not To Be 
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VOLUME MANAGEMENT DATA BASES 
LOGICAL VOLUME TABLE (LVT) 

B THE LVT IS REQUIRED AT THE FOLLOWING TIMES: 
I SEGMENT CREATION 
0 SEGMENT MOVING TIME 
H VOLUME MOUNTING AND DEMOUNTING 

0 INITIATION AND SEGMENT FAULT TIME (FOR PUBLIC /PRIVATE CHECK) 
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PHYSICAL VOLUME HOLD TABLE 



63 



11111111112222222222333333 
012345678901234567890123456789012345 


PVT R_PTR (1) 


APTE R_PTR (1) 


PVT R_PTR {2) 


APTE R_PTR(2) 






PVT R_PTR (64) 


APTE R_PTR (64) 


(WORD) (pv_holdt.ind.pl1) 



PHYSICAL VOLUME HOLD TABLE 

AN INTERNAL STATIC ARRAY IN g«_pvtx - ONE PER SYSTEM 



B THE PHYSICAL VOLUME HOLD TABLE (PVHT) IS A HARDCORE DATA BASE 
MAINTAINED BY VOLUME MANAGEMENT 



0 ONE PVHT PER SYSTEM 



THE PVHT IDENTIFIES THE PHYSICAL VOLUME AND THE PROCESS ID OF 
PROCESS THAT HAS STARTED (AND HAS NOT YET COMPLETED) COMPOUND 
OPERATIONS UPON THE PHYSICAL VOLUME 



THIS INFORMATION PREVENTS A VOLUME FROM BEING DEMOUNTED WHILE SUCH 
AN OPERATION IS IN PROGRESS 



Not 
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VOLUME MANAGEMENT DATA BASES 



PHYSICAL VOLUME HOLD TABLE 



' 8 INTERRUPTION OF A COMPOUND OPERATION CAUSES THE VOLUME TO BE MARKED 
AS CONTAINING AN INCONSISTENCY 



B FOR CRASH ANALYSIS, SSt.pvthp CONTAINS A POINTER TO THIS TABLE 
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VOLUME MANAGEMENT OPERATIONS 



ACCEPTANCE OF PHYSICAL VOLUMES 



THE ACCEPTANCE OF PHYSICAL VOLUMES IS THE MOST IMPORTANT AND 
FUNDAMENTAL OPERATION OF VOLUME MANAGEMENT 



PHYSICAL VOLUME ACCEPTANCE IS ACCOMPLISHED BY CALLING 
initializer_gate_$accept_f s_disk 



THE ROOT PHYSICAL VOLUME (RPV) IS ACCEPTED IN A SPECIAL FASHION 
DURING COLLECTION 2 OF BOOTLOAD 



THE RPV IS THE ONLY PV REQUIRED TO BOOTLOAD THE SYSTEM (MORE OF 
THE RLV WILL BE ACCEPTED BY RING ZERO DURING BOOTLOAD IF POINTED 
TO BY THE "ROOT" CONFIGURATION CARD) 



ACCEPTANCE INCLUDES: 



1 VALIDATE THAT THE DISK PACK MOUNTED IS THE PACK REQUESTED BY THE 
OPERATOR OR REQUESTING PROCESS VIA label. pvid 



| DETERMINE THAT THE DISK PACK MOUNTED IS IN FACT A MEMBER OF THIS 
HIERARCHY VIA label . root_pvid 



I INITIALIZING THE APPROPRIATE PVTE WITH DATA FROM THE LABEL, 
VOLUME MAP, AND VTOC MA.P 
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VOLUME MANAGEMENT OPERATIONS 



ACCEPTANCE OF PHYSICAL VOLUMES 



J INITIALIZING THE INITIAL CONTENTS OF THE RECORD STOCK AND VTOCE 
STOCKS 



8 DETERMINING IF ANY VOLUME INCONSISTENCIES ARE PRESENT, AND 
LOGGING THIS INFORMATION 



1 VOLUME INCONSISTENCIES ARE CAUSED BY EVENTS WHICH MAY MEAN 
THAT THE DISK RESIDENT COPY OF THE VOLUME MAP OR VTOC MAP IS 
INCONSISTENT:,:. 

I 7-£yiCBij5H ;WlTHpOT; BSD - INDICATED BY label. time_map_updated 
•" and label. time unmounted BEING UNEQUAL , DETECTED AT 
ACCEPTANCE TIME 

S AN INCONSISTENCY DETECTED ONLINE, SUCH AS AN INVALID VTOC 
BIT MAP OR A REUSED ADDRESS 

S AN I/O ERROR WHEN WRITING THE VOLUME MAP OR VTOC MAP 
DURING NORMAL OPERATION 



J A COUNT IS KEPT IN THE LABEL, AND UPDATED AS NECESSARY 



1 NORMALLY, INCONSISTENCIES ARE MERELY LOGGED, AND' LEFT FOR THE 
SITE TO TAKE CARE OF AT SOME CONVENIENT TIME 

8 IF AN RLV VOLUME CLAIMS ONLY A VERY SMALL NUMBER OF FREE 
PAGES, A VOLUME SALVAGE IS DONE AUTOMATICALLY TO TRY TO 
RECOVER ANY LOST DUE TO. THE INCONSISTENCY, SINCE A FULL 
RLV WILL CAUSE SYSTEM CRASHES 
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VOLUME MANAGEMENT OPERATIONS 



ACCEPTANCE OF PHYSICAL VOLUMES 



1 . WRITING OUT THE LABEL TO UPDATE label .timejna p_updated. . 

J NOTE: label. time map_updated AND label . time_unmounted ARE 
NOW UNEQUAL 

fl THIS INEQUALITY IMPLIES THAT THE VOLUME HAS NOT BEEN PROPERLY 
SHUT DOWN, AND WILL BE MARKED INCONSISTENT IF ACCEPTED AGAIN 
IN THIS STATE 



| MARRING THE PVTE AS "IN USE" (LAST STEP) 
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VOLUME MANAGEMENT OPERATIONS 



DEMOUNTING OF PHYSICAL VOLUMES 



a THE DEMOUNTING OF PHYSICAL VOLUMES INVOLVES REVERSING ALL OF THE 
STEPS TAKEN AT ACCEPTANCE TIME 



8 DEMOUNTING IS COMPLICATED BY THE FACT THAT THE PV MAY BE IN USE AT 
THE TIME 



B "DEMOUNT! NG IS ACCOMPLISHED BY CALLING demountjpv ( "THE DEMOUNTER" ) 



a ALL VOLUMES ARE DEMOUNTED AT SHUTDOWN TIME 



a DEMOUNTING INCLUDES: 



B TURNING ON pvte . being_demounted AND WAITING FOR ALL COMPOUND 
OPERATIONS TO TERMINATE 



0 DEACTIVATING ALL SEGMENTS FROM THE PV WHICH ARE ACTIVE. THIS 
INCLUDES: 



8 FLUSHING MAIN MEMORY AND PAGING DEVICE (IF PRESENT) OF ALL 
RELEVANT PAGES 
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VOLUME MANAGEMENT OPERATIONS 
DEMOUNTING OF PHYSICAL VOLUMES 

0 UPDATING THE VTOCE'S FROM THE ASTE'S AND PAGE TABLES 

J FLUSHING THE VTOC MANAGER'S BUFFER SEGMENT OF ALL RELEVANT 
VTOCE-PARTS 

I EMPTYING THE RECORD AND VTOCE STOCKS BACK INTO THE VOLUME MAP 
AND VTOC MAP 

. Q UPDATING THE VOLUME LABEL FROM THE PVTE, PARTICULARLY 

Q label . time_unmounted, label . time_map_upda ted , AND 
label . inconsistency__count 

jj PHYSICALLY CYCLING DOWN THE DISK DRIVE 

S NOT DONE AT SYSTEM SHUTDOWN, HOWEVER 

i 

a • ONLY ONE PV MAY BE DEMOUNTED AT A TIME 
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VOLUME MANAGEMENT OPERATIONS 



LOGICAL VOLUME MANAGEMENT 



8 LOGICAL VOLUME MANAGEMENT INCLUDES: 



8 MAINTAINING THE LOGICAL VOLUME TABLE (LVT) TO REFLECT THE STATE 
OF THE LOGICAL VOLUMES 



0 MAINTAINING, IN THE KNOWN SEGMENT TABLE (KST) OF EACH PROCESS, A 
TABLE OF PRIVATE LOGICAL VOLUMES MOUNTED TO THE PROCESS 



| ANSWERING THE QUESTION OF WHETHER OR NOT A GIVEN LOGICAL VOLUME 
IS MOUNTED TO THE CALLING PROCESS 



8 OR, IF A PUBLIC LV, MOUNTED AT ALL (TO THE SYSTEM) 



8 PROVIDING THE HEAD OF THE PVT CHAIN FOR A GIVEN LV, FOR THE 
SEGMENT CREATION FUNCTION 
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print configuration deck 



ss PR I NT__CONF I GURATI ON_DECK - DISPLAYS >sll>conf ig_dec k , WHICH 
CONTAINS INFORMATION ABOUT DISK LOCATIONS, THE RLV, AND PARTITIONS 



|" ONLY THE PART OF ' THE CONFIG DECK RELEVANT TO VOLUME MANAGEMENT 
AND DISK CONFIGURATION IS SHOWN HERE 



root 


dska 


16. 


dskb 


25. dskb 23 


dskb 


part' 


"bos 


dska 


" "16. 








part 


dump 


dska 16 








part' 


... log 


dska 


.16. 








prph 


dska 


a 


20. 


2 


451. 16. 




chnl 


dska 


a 


26. 


2 


b 24. 2b 


22. 2 


prph 


dskb 


b 


20. 


2 


0 16. 451. 


16. 


chnl 


dskb 


b 


26. 


2 


a 24. 2 a 


22. 2 


prph 


dskc 


a 


28. 


2 


501. 32. 




chnl 


dskc 




30. 


2 


b 30. 2 b 


28. 2 


prph 


dske 


b 


32. 


2 


451. 8. 




chnl 


dske 


o 










prph 


dskf 


a ' 


32. 


2 


501. 16. 




chnl 


dskf 


a 


34. 


2 






mpc 


mspa 


451. 


a 


20. 


4 a 24. 


4 


mpc 


mspb 


451. 


b 


20. 


4 b 24. 


4 


mpc 


mspc 


607. 


a 


28. 


4 




mpc 


mspd 


607. 


b 


28. 


4 




mpc 


mspe 


451. 


b 


32. 


4 




mpc 


mspf 


607. 


a 


32. 


4 





24. dska 8. 



Not To Be Reproduced 



6-38 



F80A 



VOLUME MANAGEMENT COMMANDS 
print configuration deck 

DISK CONFIGURATION CONFIG CARDS 
J ROOT 

I IDENTIFIES THOSE VOLUMES IN THE ROOT LOGICAL VOLUME WHICH 
HAVE HO PARTITIONS, USED BY THE SUPERVISOR FOR PAGING OF 
SUPERVISOR SEGMETNS 

1 PART 

. S IDENTIFIES THE LOCATIONS OF CERTAIN IMPORTANT PARTITIONS 

8 ONLY PARTITIONS NECESSARY FOR MULTICS OPERATIONS ARE 
IDENTIFIED, NOT ALT PARTITIONS 

| HC PARTITIONS ARE LOCATED BY THE ROOT CARD 

J PRPH DSKn , CHNL 

8 IDENTIFY PHYSICAL I /O CHANNEL 'PATHS FOR ACCESSING DISK DRIVES 

| MPC 

fl IDENTIFY PHYSICAL CONNECTIONS TO MICROPROGRAMMED DISK 
CONTROLLERS 
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list VP } s 

e LiST_VOLS - DISPLAYS A TABLE OF ONLINE VOLUMES, THEIR LOCATION, AND 
SPACE UTILIZATION 



Dr i ve 


Records 


Left 




VTOCEs 


Left 


% 


Avg 


PV 


PB/PD 


LV Name 


















S i ze 


Name 














cskc_ 1 7 


64504 


54730 


85 


13440 


1 1356 


84 


4 


a 1 phaO 1 


pb 


pd 


A 1 pha 






dskc_ 1 8 


64504 


55389 


86 


13440 


11352 


84 


4 


a 1 pha02 


pb 


pd 


Alpha 




• 


2Ske_05 


36^28 


5305 


15 


S400 


2662 


32 


* 5 


mul03 


pb 


Pd 


Mul t 


cs_ 


Pubs 


dska_06 


36428 


4323 


12 


8400 


2365 


28 


5 


mulOl 


Pb 


Pd 


Mul t 


cs_ 


Pubs 


dskb_ 1 9 


36428 


4632 


13 


8400 


2513 


33 


5 


mul02 


Pb 


Pd 


Mul t 


cs_ 


Pubs 


asko_2o 


3642° 


13690 


38 


84C0 


4326 


52 


5 


mu!05 


Pb 


Pd 


Mul t 


cs_ 


'pubs 


dskb_2/ 


3&L29 


4672 


13 


8L00 


2333 


28 


5 


mu104 


pb 


Dd 


Mul t 


cs 


Pubs 


cs k s_0 1 


36308 


4680 


13 


9000 


450 


5 


3 


pubO 1 


pb 


od 


Publ 








dsks_03 


3c-2dS 


3585 


10 


9200 


1017 


1 1 


3 


pub07 


ps 


Pd 


Publ 


c 




dska_04 


io2ofc 


450C 


12 


9200 


884 


10 


3 


puoOL 


Pw 


pd 


Pub i 


r 




ds kc_0$ 


3626S 


4 5 1 6 


13 


9200 


864 


9 


< 
•< 


pubC2 


pb 


pd 


Publ 


c 




dskb_l 7 


36269 


L2 ^ 1 


12 


9200 


1002 


1 1 


3 


pub05 _ 


po 


pd 


Publ 


c 




Cskb_16 


36268 


3840 


1 1 


9200 


539 


6 


3 


pubOS 


pb 


Pd 


rub 1 


c 




askc_ 1 3 


6450L 


294 


0 


13L1*0 


5539 


41 


8 


relOl 






Re 1 ease 




dskc_ 1L 


64504 


269 


0 


1 3^40 


5214 


39 


7 


rel02 






Re 1 ease 




dskc_C 1 


64503 


43631 


68 


13440 


ICO32 


75 


6 


xpubOl 


pb 




Xpuo 




c 




cskc_C2 


64503 


45502 


71 


1 3440 


9838 


73 


5 


xpub02 


pb 




Xpub' 


c 




dskc_03 


6L503 


42374 


66 


1 3440 


9839 


73 


6 


xpub03 


Pb 




Xoubl 


c 




ask c_0* 


64503 


43591 


68 


13440 


5785 


73 


5 


xpub04 


pb 




Xpub 




c 




dskc_09 


64501; 


58010 


90 


13440 


12394 


92 


6 


xpub05 


Pb 




Xpub 1 


c 




dskc_10 


64504 


56786 


.88 


13440 


12407 


92 


7 


xpubOo 


pb 




Xpub 1 


c 




ask c_2 1 


64503 


23947 


37 


13^40 


6446 


48 


5 


ypubO 1 


Pb 




Youb 




r- 




ask c_Z2 


64503 


237i*4 


37 


1 3440 


6194 


46 


5 


ypub02 


pb 




YpuD 




r 




dskc_29 


64503 


23794 


37 


1 3440 


6185 


46 


5 


ypub05 


pb 




Ypubl 






»4 I. «- *• 

CSkC_jj 


o*o03 


■24 - i 1 


37 


1 3L40 


6481 


48 


5 


ypub06 


Pb 




Youbl 








64503 


11723 


1 0 
- 0 


l j>i+i+U 


6149 


1 r 
MO 


7 


ZpubC 1 


pb 


pd 


Zpub 




c 




askc^OB 


64503 


11665 


18 


13440 


6429 


48 


7 


2pub02 


pb 


Pd 


Zpub 1 


c 




dskc_23 


64504 


9777 


15 


13440 


6094 


45 


7 


zpub03 


pb 


pd 


Zpub 


i c 




dskc_24 


64504 


11805 


18 


13440 


6141 


46 


7 


zpubOL 


Pb 


Pd 


Zpubl i c 




dskc_25 


64504 


11514 


18 


13440 


7407 


55 


8 


zpub05 


pb 


Pd 


Zpub 1 i c 




dskc~26 


64504 


12958 


20 


13440 


7149 


53 


8 


zpub06 


Pb 


Pd 


Zpub 


i c 




dske_Ot> 


37089 


8053 


22 


5100 


3797 


74 


22 


1 istOl 


Pb 


Pd 


1 ist 


1 




dska_12 


37562 


6046 


16 


2735 


957 


35 


17 


1 ist02 


Pb 




1 ist" 


2 




dska~07 


37309 


6825 


18 


4000 


2107 


53 


16 


1 i st03 


pb 




1 ist" 


3 




dska_08 


36209 


3827 


1 1 


7000 


491 


7 


4 


root5 


Pb 




root 








dska~l 1 


36209 


8597 


24 


7000 


4181 


60 


9 


root6 


pb 




root 








dska_16 


31283 


2892 


9 


9000 


3476 


39 


5 


rpv 


pb 




root 








dskb_23 


36208 


4S8S 


13 


7000 


455 


7 


4 


root3 


pb 




root 








dskb_2* 


36209 


3097 


9 


7000 


238 


3 


4 


root4 


pb 




root 








dskb_2? 


36350 


4483 


12 


7000 


223 


3 


4 


root2 


pb 




root 
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VOLUME MANAGEMENT COMMANDS 



display label 



s DISPLAY_LABEL - DISPLAYS THE LABEL OF A STORAGE SYSTEM VOLUME BY 
READING IT FROM DISK 



i USED / FREE INFORMATION IS COPY ON DISK, AND THEREFORE OUT OF 
DATE WITH RESPECT TO THE PVTE 



Label for Multics Storage System Volume rpv on dska_01 d451 



PVID 
Serial 

Logical Volume 
LVID 

Registered 

Dismounted 

Map Updated 

Salvaged 

Boot load 

Reloaded 

Dumped 

I ncremental 

Consolidated 

Complete 



220531524345 
rpv 
root 

220531524466 



01/28/81 
03/15/83 
03/15/83 
10/01/82 
03/15/83 
01/28/81 

03/17/83 
03/16/83 
03/15/83 



1249.5 
0741.9 
0744.6 
0300.3 
0743.5 
1510.1 

2153.0 
2359.3 
2353.0 



Inconsistencies 


0 






Minimum AIM 0 


:000000 






Maximum AIM 7 


:777777 






Volume contains Root 


(>) at vtocx 0 




disk_table_ at vtocx 100 (uid 


033022210261) 


Map from Label 








First Rec (Octal) 


Size 






0 0 


8 


Label 


Region 


8 10 


2000 


VTOC 


Region 


2008 3730 


2008 


he 


Partition 


4016 7660 


33901 


Paging 


Region 


37917 112035 


200 


bos 


Partition 


38117 112345 


141 


alt 


Partition 




38258 


Total 


Size 
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VOLUME MANAGEMENT COMMANDS 
display pvte 



§5 DISPLAY PVTE - DISPLAYS THE PVT ENTRY OF A STORAGE SYSTEM VOLUME 



1 PARTITION INFORMATION IS NOT DETAILED IN THE PVTE, BUT USED/FREE 
INFORMATION IS COMPLETELY UP TO DATE 



PVTE for Multics Storage System Volume rpv on dska_01 d45l at pvt | 50 
PVID * 22053.1524345 

LVID 220531524466 



VTOCEs 




Number 


10000 


Left 


3323 


Records 




Number 


33901 


Left 


3796 


Inconsistencies 


0 


Volume Map 




volmap_seg ASTE 


15 | 4420 


record stock 


761100 


Page 0 - Base 


7660 


TTt — _ _ 

r .l cc 


■3 r> £. A 

■J .J \J1 


Page 1 - Base 


103660 


Free 


3740 


Page 2 - Base 


203660 


Free 


0 


vtoce stock 


76 | 2400 


ON: storage_ 


system pe 



OFF : 



Volume Map from PVTE 



being_mounted being_demounted be ing__demounted2 
scav_check_address device_inoperat i ve vacating 
dmpr_in_use ( incr ) dmpr_in_use (cons ) dmpr_in_use { comp ) 



First Rec 
0 
8 

2008 
4016 
37917 



(Octal) 
0 
10 
3740 
7660 
112035 



Size 
8 

2000 
2008 

33901 
199 

38258 



Label Region 
VTOC Region 
Partitions 
Paging Region 
Partitions 
Total Size 
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VOLUME MANAGEMENT METERS 



disk meters 



S DISK_METERS ~ DISPLAYS I/O ACTIVITY TO DISK DRIVES 
0 ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 



Total metering time 0:20:12 * 

Subsystem dska Count Waits %Waits Avg. Wa i t ( ms . ) 



call locks 




26005 


217 


0.83 


0.259 




run locks 




112 


0 


0.00 


0.000 




interrupt 


locks 


25998 


239 


0.92 


0.208 




allocations 


26001 


0 


0.00 


0.000 




Drive 


Reads 


Writes 


Seek 


ATB 


ATB 


ATB 








Distance 


Reads 


Writes 


I/O 


1 


269 


67 


214 


4508 . 


18102 


3609 


3 


362 


243 


109 


3350 


4991 


2004 


4 


309 


131 


184 


3925 


9258 


2756 


5 


547 


165 


i80 


2217 


7350 


1703 


6 


631 


165 


161 


1922 


7350 


1523 


7 


0 


0 


o • 


0 


0 


0 


S 


5843 


2187 


1 -51 


207 


554 




9 


366 


116 


153 


3313 


10455 


2516 


11 


3501 


1431 


200 


346 


847 


245 


12 


0 


0 


0 


0 


0 


0 


16 


7158 


2508 


135 


169 


483 


125 
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VOLUME MANAGEMENT METERS 



device meters 



DEVI GEOMETERS - DISPLAYS SUMMARY OF I/O ACTIVITY FOR ALL DISK 
SUBSYSTEMS 



Total metering time 0:20:13 





dska 


dskb 


dskc 


dskd 


Prior Page I/O 


18571 


17743 




462 


1273 


ATB 


65.334 


68.383 


2626 


.240 


953.121 


Other Page I /O 


6525 


5135 




16 


696 


ATB 


185.949 


236.284 


75832 


.692 


1743.280 


ATB Page I/O 


48.347 


53.034 


2538 


.332 


616.212 


Prior VTOCE I/O 


934 


895 




38 


304 


ATB 


1299.061 


1355.668 


31929 


.554 


3991.194 


ATB I/O 


46.612 


51.037 


2351 


.401 


533.798 


% Busy 


76 


74 




0 


4 


Avg. Page Wait 


47.289 


46.197 


20 


.341 


24.666 


Avg. Page A Wait 


176.082 


101.023 


36 


.996 


61.704 


Avg VTOCE Wait 


41.138 


37.610 


38 


.595 


29.090 


Avg . Page I /O T 


35.619 


38.314 


20 


.050 


22.482 


Avg. VTOCE I/O T 


31.139 


32.277 


37 


.060 


26.606 


EDAC Corr. Errs 


0 


0 




0 


0 


Errors 


0 


0 




0 


1 


Fatal Errors. 


0 


0 




0 


0 
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VOLUME MANAGEMENT METERS 



disk queue 



B DISK_QUEUE - DISPLAYS I/O QUEUE FOR A DISK SUBSYSTEM 



| ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 



Connects = 2604781, 1359725, 677321, 309367, 
123430, 40159, 10227, 1969. 



p 


RW 


VP 


DV 


SECTOR 


MEM 


0 


W 


p 


24 


1350330 


27304000 


0 


W 


p 


9 


1020150 


4432000 


0 


w 


p 


16 


1204130 


36246000 


0 


w 


p 


16 


314370 


27306000 


0 


w 


p 


16 


314430 


34166000 
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SEGMENT CONTROL OVERVIEW 



B FUNCTION 



| SEGMENT CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF LOGICAL 
MEMORY 



Q ITS TASKS INCLUDE: 

1 MAINTAINING THE DISK RESIDENT MAPS OF SEGMENTS (IE: THEIR 
VTOCE'S) 

| SEGMENT CREATION , TRUNCATION AND DELETION 

jj SEGMENT ACTIVATION AND DEACTIVATION (ASTE MULTIPLEXING) 



8 SEGMENT CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
SEGMENT FAULTS 



B BASIC PHILOSOPHY OF ACTI VATI ON /DEACTI VATI ON 



A OF ALL SEGMENTS RESIDENT WITHIN THE SYSTEM'S MOUNTED PHYSICAL 
VOLUMES, ONLY A SMALL SUBSET WILL REQUIRE ACCESSING AT ANY ONE 
TIME, SUCH SEGMENTS WILL BE CALLED "ACTIVE SEGMENTS" 



Q A PART OF MAIN MEMORY, CALLED THE "ACTIVE SEGMENT TABLE" (AST), 
WILL BE RESERVED TO HOLD MANAGEMENT INFORMATION FOR THESE ACTIVE 
SEGMENTS (IDENTITY, PVT INDEX, LOCATION OF PAGES, ETC.) 
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SEGMENT CONTROL OVERVI EW 

| AS SEGMENTS FALL INTO DISUSE, THEIR "MANAGEMENT INFORMATION" IN 
THE AST WILL BE REPLACED WITH INFORMATION OF OTHER SEGMENTS 
REQUIRING ACTIVATION 

USER INTERFACE 

0 COMMAND LEVEL 

| create, delete, truncate, etc' 

| SUBROUTINE LEVEL 

J hcs_$append_branch , hcs_$append_branchx , hcs_$delentry_seg , 
hcs_$delentry_f ile , hcs_$truncate_seg , hcs_$truncate_f i le , 
hcs_$f orce__wr ite , etc 

MAJOR DATA BASES 

| SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM, SHARED WITH PAGE 
CONTROL. ONE MAJOR COMPONENT IS "OWNED" BY SEGMENT CONTROL: 

0 ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 

D THE AST IS A LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 

0 ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 

j] ASTES CONTAIN PHYSICAL VOLUME ID'S (PVID'S) AND VTOC 
INDEX'S (VTOCX'S) OF SEGMENTS. NEEDED BY SEGMENT CONTROL 
TO FIND THE SEGMENT ON DISK (HARDWARE) 

t To Be Reproduced 7-2 F80A 



SEGMENT CONTROL OVERVIEW 

B AST HASH TABLE 

B ALLOWS EFFICIENT SEARCHING OF ASTE'S 

B LOGICALLY PART OF THE AST, BUT ELSEWHERE FOR HISTORICAL 
REASONS 

B DIRECTORY SEGMENTS 

B CONTAIN LOCATIONS AND ATTRIBUTES OF SEGMENTS. LOCATION 
INFORMATION FROM DIRECTORY SEGMENTS IS PROVIDED TO SEGMENT 
CONTROL BY DIRECTORY CONTROL 

VOLUME TABLE OF CONTENTS (VTOC) - ONE PER PHYSICAL VOLUME 

1 VOLUME TABLE OF CONTENTS ENTRY (VTOCE) - ONE PER 
DT SK-RESIDENT SEGMENT 

| EACH VTOCE CONTAINS THE SEGMENT'S UNIQUE ID, CURRENT LENGTH, 
FILE MAP, ETC (NEED TO BUILD ASTE'S AND PT'S) 

D VTOCES ARE READ AND WRITTEN ONLY BY SEGMENT CONTROL 

| VTOCE STOCKS - FROM VOLUME MANAGEMENT 

| USED WHEN CREATING AND DELETING VTOCES FOR SEGMENTS 
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SEGMENT CONTROL TERMINOLOGY 



MULTIPLEXING: CONTROLLED SHARING OF A REUSABLE RESOURCE 



VTOC: 



VOLUME TABLE OF CONTENTS (ONE PER PV) . AN ARRAY OF 
VTOCE'S IDENTIFYING ALL SEGMENTS RESIDENT ON THE 
PHYSICAL VOLUME 



VTOCE : 



VOLUME TABLE OF CONTENTS ENTRY (ONE PER RESIDENT 
SEGMENT). CONTAINS IDENTIFICATION AND LOCATOR 
INFORMATION ABOUT A SEGMENT RESIDENT WITHIN THE 
PHYSICAL VOLUME 



SEGMENT: 



A COLLECTION OF INFORMATION (PROCEDURE OR DATA) GROUPED 
TOGETHER UNDER THE SAME ACCESS CONTROL CONSTRAINTS. 
EACH SEGMENT IS GIVEN ONE OR MORE NAMES AND A 
COLLECTION OF ATTRIBUTES INCLUDING LENGTH, ACCESS 
PERMISSIONS, ETC 



SEMI -PERMANENT ACTI VATISS : A SEGMENT AND TURNING ON ITS ENTRY HOLD 
SWITCH (aste.ehs) PREVENTING NORMAL (ASTE CONTENTION) 
DEACTIVATION 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC ) 



1 '1'1!1111222222222 2Sl 3 3 3 3 3 
01234567S901231SS7890123.15S7 8^9 0 1 2 3 i 5 



SEGMENTS UNIQUE IDENTIFIER (UIO) 



MAX LENGTH 



CURRENT LENGTH 



RECORDS USED 



DATE TIME USED <DTU) 



DATE TIME MODIFIED (DTM! 



PILE MAP CHECKSUM 



10 WORDS OF QUOTA RELEVANT INFORMATION TO INCLUDE 
THE TIME-RECORD PRODUCT ANO USAGE COUNT 



10 WORDS NOT USED 



< 



— f . no? C\ c\iS*^ 







3 


f 


16 


FILE MAP (0) 


FILE MAP <U 


3 


4 




• 


• 






63 


FILE MAP (94) 




FILE MAP (95) 


» 




64 


FILE MAP (961 


FILE MAP (97) 


4 










— S3 
< 3 

f 


3. 

■ < 

s 


127 . 


FILE MAP (2221 


FILE MAP (223) 




128 


FILE MAP (2241 




FILE MAP (225! 


* 








_ « 




143 


FILE MAP (2S4I 




FILE MAP (255) 




» 











8 > u ^ i j( i 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC) 





SEGMENT CONTROL DATA BASES 




VOLUME TABLE OF CONTENTS VTOCE 


154 


?! «ig^M£§iai 




■■' w ? m m m • m ■ mmmm mm mmmm 




155 


DATE TIME DUMPED (OTOI 


156 


VOLUME 10 (1) (INCREMENTAL DUMP TAPE ID) 


157 


VOLUME 10 (2) (CONSOLIDATED DUMP TAPE ID) 


158 


VOLUME ID (31 (COMPLETE DUMP TAPE 101 


159 


UID OF MASTER DIRECTORY 


160 


UIO OF SUPERIOR DIRECTORY (01 






175 


UID OF SUPERIOR DIRECTORY (15) 




l— I u 1 




8 WORDS CONTAINING THE SEGMENT'S 
ORIGINAL PRIMARY NAME 

" \ ■ ■ \ 


184 


DATE.TIME VTOCE CREATED 


185 


PVID OF VOLUME OF PARENT DIRECTORY 


186 


PARENT VTOC INDEX 


SEGMENT BRANCH OFFSET IN PARENT 


187 


TIME THIS VTOCE CHECKED FOR CONNECTION FAILURE 


188 


ACCESS ISOLATION MECHANISM <AIMI CLASS 


190 




191 


PVIO OF VOLUME FOR THIS VTOCE 




(WORDS) 


ivtoce.incl.pll) 



_ z 

v> — 

= 5 z 

i* I 



VOLUME TABLE OF CONTENTS ENTRY (VTOCE) 

A DISK RESIDENT DATA BASE - ONE PER SEGMENT 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC) 



B THE "VOLUME TABLE OF CONTENTS" (VTOC) IS A DISK RESIDENT DATA BASE 
CONTAINING (OF INTEREST HERE) AN, ARRAY OF ENTRIES KNOWN AS "VOLUME 
TABLE OF CONTENTS ENTRIES" (VTOCE'S) 



J ONE VTOC PER PHYSICAL VOLUME 



| ONE VTOCE PER SEGMENT 



8 EACH VTOCE CONTAINS RESIDENCY INFORMATION (AND SOME ATTRIBUTE 
INFORMATION) OF A PARTICULAR SEGMENT 



B EACH VTOCE IS ADDRESSED BY INDEXING INTO THE ARRAY OF VTOCE ' S 



1 CONSEQUENTLY, THE' PAIR OF PVID AND VTOC INDEX UNIQUELY 
IDENTIFIES ANY SEGMENT IN THE STORAGE SYSTEM HIERARCHY 



EACH VTOCE IS 192 WORDS LONG AND IS DIVIDED INTO THREE LOGICAL 
PARTS : 



fl ACTIVATION INFORMATION (16 WORDS) 

0 CONTAINS ALL INFORMATION (EXCLUDING THE FILE MAP) NEEDED TO 
USE THE SEGMENT, OR MORE TECHNICALLY, TO ACTIVATE THE SEGMENT 
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SEGMENT CONTROL DATA BASES 
VOLUME TABLE OF CONTENTS (VTOC') 



1 INCLUDES: UXD, CURRENT LENGTH, RECORDS USED, MAXIMUM 
LENGTH , RECORDS USED, ETC 

| ALL INFORMATION LIKELY TO CHANGE BECAUSE OF THE ACTIVATION 

I INCLUDES: DATE TIME MODIFIED AND USED, QUOTA CELLS (IF A 
DIRECTORY) , ETC 



FILE MAP (128 WORDS) 

| AN ARRAY OF 256 RECORD ADDRESS OR NULL ADDRESS DETAILING 
WHERE EACH PAGE OF THE SEGMENT RESIDES 

fl A NULL ADDRESS (NOT TO BE CONFUSED WITH A NULLED ADDRESS — 
DISCUSSED LATER) INDICATES THAT NO RECORD OF THE VOLUME IS 
ASSIGNED TO- THAT PAGE OF THE SEGMENT 

fl A RECORD ADDRESS IS THE ADDRESS OF THE RECORD ASSIGNED TO 
THAT PAGE OF THE SEGMENT (I.E., THE DISK RESIDENT HOME OF THE 
PAGE) 

U NOTE: PAGE CONTROL ENSURES THAT NO RECORD ADDRESS EVER 
APPEARS (OR REMAINS) IN THE FILE MAP UNLESS THE PAGE ACTUALLY 
APPEARS ON THE VOLUME 



PERMANENT INFORMATION (48 WORDS) 

| CONTAINS ATTRIBUTES WHICH RARELY (IF EVER) CHANGE SUCH AS: 

| UID'S OF SUPERIOR DIRECTORIES, AIM CLASSIFICATION, DATE 
TIME. DUMPED (BY PHYSICAL VOLUME DUMPER) 
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SEGMENT CONTROL DATA BASES 
VOLUME TABLE OF CONTENTS (VTOC) 



8 EACH VTOCE IS ALSO DIVIDED INTO THREE PHYSICAL PARTS : 



| FIRST SECTOR (WORDS 0-63); 

1 CONTAINS ALL "ACTIVATION INFORMATION" AND THE FIRST PORTION 
OF THE FILE MAP 



1 SECOND SECTOR (WORDS 64-127): 

1 CONTAINS THE BULK OF THE FILE MAP 

0 THIRD SECTOR (WORDS 128-191): 

8 CONTAINS THE END OF THE FILE MAP AND ALL " PERMANENT 

INFORMATION" 
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SEGMENT CONTROL DATA BASES 



VOLUME TABLE OF CONTENTS (VTOC) 



B VTOCE I/O 



USING RECORD I/O (IN UNITS OF 1024 WORDS) TO ACCESS A VTOCE (192 
WORDS) WOULD HAVE EXCESSIVE OVERHEAD FOR BUFFERS 



FURTHERMORE, BECAUSE MOST SEGMENTS ARE SMALL, MOST VTOCE 
ACCESSING IS ONLY CONCERNED WITH ACTIVATION INFORMATION AND THE 
FIRST PORTION OF THE FILE MAP, I.E., THE FIRST SECTOR (64 WORDS) 



| TO TAKE ADVANTAGE OF THESE FACTS, VTOCE 'S ARE ACCESSED VIA 
SECTOR I/O, NOT RECORD I/O 



D A LARGE MECHANISM KNOWN AS THE VTOC MANAGER (vtoc_man) EXIST TO 
EFFICIENTLY MANAGE THIS SECTOR I /O AND ITS BUFFERING 



0 VTOCE I/O IS THE ONLY NON-PAGE I/O DONE TO DISK 



D VTOCE I/O IS DONE IN PARTS (SECTORS) 



FOR A SEGMENT , OR A DIRECTORY WITHOUT TERMINAL QUOTA , PARTS 
ONE AND TWO CAN 3E WRITTEN ENTIRELY FROM INFORMATION DERIVED 
FROM THE ASTE, AND NEED NOT BE READ IN FIRST 



PART THREE MUST ALWAYS BE READ BEFORE BEING WRITTEN, AS MUS' 
PART ONE FOR A DIRECTORY WITH QUOTA 



0 ALL THREE PARTS OF A VTOCE ARE ALWAYS READ WHENEVER ANY PART 
IS REQUESTED, IN CASE THE OTHERS ARE NEEDED SOON AFTERWARDS 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



11111111112222222222333333 
01234S678901234SS73901234S6799012 345 



FORWARD R PTR 



BACKWARD R PTR 



NEXT BROTHER R PTR 



FIRST SON R PTR 
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RECORDS USED 



MO. OF PAGES 



HASH TABLE R PTR 



MARKER 



ACTIVE SEGMENT IABLE £NTRY (ASTE) 

A WIRED (SST) OATA BASE - ONE PER ACTIVE SEGMENT 



(asta.ind.pt 1) 
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MAIN MEMORY ADDRESS j 0000 


i 
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NULL AOORESS - REPRESENTS PAGE OF ZEROES 


I 

0000 '. 



Spc) ^ \ 



A 16K PAGE IABLE (FT) 



IMMEDIATELY FOLLOWS AN ASTE (ABOVE! - ONE PER ACTIVE SEGMENT 
COMES IN 4. 16. 64 AND 2S6K FLAVORS 




iPTW.INCL.PLl) 



r 



l Of 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



THE ACTIVE SEGMENT TABLE (AST) IS A HARDCORE, WIRED, UNPAGED, DATA 
BASE LOCATED WITHIN THE SYSTEM SEGMENT TABLE (SST), AND CONSISTS OF 
AN ARRAY OF PAIRED ENTRIES KNOWN AS ACTIVE SEGMENT TABLE ENTRIES 
(ASTE'S) AND PAGE TABLES (PT'S) 



Q ONE AST PER SYSTEM 



D ONE ASTE/PT PAIR PER ACTIVE SEGMENT 



IN ORDER FOR A SEGMENT TO BE ACCESSED VIA THE HARDWARE, VTOCE 
INFORMATION MUST BE BROUGHT INTO MAIN MEMORY 



THE 12 WORD ASTE (AND ITS ASSOCIATED PAGE TABLE) CAN BE THOUGHT OF 
AS THE MAIN MEMORY RESIDENT IMAGE OF THE VTOCE 



g SPECIFICALLY, THE ASTE CONTAINS: 

C THE VTOCE ' S "ACTIVATION INFORMATION" SUCH AS THE SEGMENTS 
UID, CURRENT LENGTH, MAX LENGTH, DTU, DTM , QUOTA DATA 

| AND NON-VTOCE INFORMATION SUCH AS: PVT INDEX , VTOC INDEX, 
VARIOUS FLAGS AND POINTERS 



THE PAGE TABLE CONTAINS THE RECORD ADDRESS (TAKEN FROM THE 
VTOCE' S "FILE MAP") OF EACH NONZERO PAGE OF THE SEGMENT 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



B A SEGMENT HAVING AN ASTE AND A PAGE TABLE IS SAID TO BE ACTIVE 



"ACTIVATING" A SEGMENT IS THE PROCESS OF ALLOCATING (AND FILLING 
IN) AN ASTE AND A PAGE TABLE FOR THE SEGMENT 



CONVERSELY, "DEACTIVATING" A SEGMENT INVOLVES FREEING ITS ASTE 
AND PAGE TABLE FOR FURTHER USE 



| BEING ACTIVE DOES NOT IMPLY THAT THE SEGMENT IS ACTUALLY IN USE 
BY ANY PROCESS 



B SINCE THE AST IS A PART OF A SINGLE SEGMENT (HAVING FINITE SIZE), 

mtjr? vrTTTufDrr) r\Tr> jcto /nrv n> tdc t r orxtTmp t i/nr ",t t \to . 
x. x~ixw hui-xuxuxa wt njiu/ri rnxxvj x »J c xi<ii :£i f x ui. nxvj , 



1 ONLY A FINITE NUMBER OF SEGMENTS MAY BE ACTIVE AT ONE TIME 



WHEN A NON- ACTIVE SEGMENT IS REFERENCED, AND THERE ARE NO FREE 
ASTE'S AVAILABLE, SOME SEGMENT MUST BE DEACTIVATED 



1 THIS ASTE/PT .MULTIPLEXING IS THE PRIME RESPONSIBILITY OF 
SEGMENT CONTROL 



| BEING A FINITE (AND A CRITICAL) SYSTEM RESOURCE, THE NUMBER OF 
ASTE/PT PAIRS CAN DRAMATICALLY AFFECT THE COMPETITION FOR 
ASTE'S, AND CONSEQUENTLY SYSTEM PERFORMANCE 
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SEGMENT CONTROL DATA BASES 
ACTIVE SEGMENT TABLE (AST) 



TOO FEW ASTE/PT PAIRS WILL CAUSE " SEGMENT THRASHING" 



TOO MANY ASTE/PT PAIRS WILL OCCUPY MAIN MEMORY FRAMES THAT 
MIGHT BETTER BE UTILIZED FOR NORMAL PAGING TRAFFIC, PERHAPS 
LEADING TO "PAGE THRASHING" 



CONSEQUENTLY, THE NUMBER OF ASTE/PT PAIRS IS A CRITICAL 
SYSTEM PARAMETER (SET ON THE SST CONFIG CARD) 

| OF THE TWO POSSIBILITIES, TOO MANY OR TOO FEW, TOO FEW IS 
BY FAR THE WORSE 
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CONNECTING AND FAULTING SDW'S 




Brown. FORD, a 

PROCESS 
Smith. FED a 



SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



B IN ORDER TO MAXIMIZE THE NUMBER OF ASTE/PT PAIRS WITHIN AN AST OF A 
GIVEN SIZE, ASTE/PT PAIRS COME IN FOUR FIXED SIZES*. 

| ASTE + A 4 WORD PAGE TABLE (16 WORDS TOTAL) 
D" FOR 0-4K SEGMENTS 

I ASTE + A 16 WORD PAGE TABLE (28 WORDS TOTAL) 
| FOR 5-1 6K SEGMENTS 

0 ASTE + A 64 WORD PAGE TABLE (76 WORDS TOTAL) 
B FOR 17-64K SEGMENTS 

y ASTE + A 256 WORD PAGE TABLE (268 WORDS TOTAL) 
| FOR 65-256K SEGMENTS 
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SEGMENT CONTROL DATA BASES 



ASTE 



4 WO PT 
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POOL 
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POOL 



64K ASTE 
POOL 



256K ASTE 
POOL 



ACTIVE SEGMENT TABLE (AST) 

A HARDCORE (SST) UN-PAGED DATA BASE - ONE PER SYSTEM 
(NOT DRAWN TO SCALE) 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



s THE SIZE OF EACH OF THE FOUR ASTE POOLS IS DETERMINED AT SYSTEM 
INITIALIZATION BY THE SST CONFIG CARD AND IS A CRITICAL SYSTEM 
TUNING PARAMETER 



B SINCE THE FREQUENCY OF SMALL SEGMENTS IS HIGHER THAN THE FREQUENCY 
OF LARGE SEGMENTS, THE DISTRIBUTION OF ASTE'S IS NORMALLY AS 
FOLLOWS : 



0 4K > 16K > 64K > 256K 

Q ON SYSTEM-M, IN PHOENIX, A 6 CPU, 8MW MEMORY, 200 USER SYSTEM, 
THE ASTE DISTRIBUTION IS NORMALLY: 

3500 1500 750 250 

ON MIT-MULTICS, A 3 CPU, 3 . 5MW MEMORY , 110 USER SYSTEM, THE ASTE 
DISTRIBUTION IS NORMALLY: 

1700 600 220 75 



B A SEGMENT NORMALLY REMAINS ACTIVE (FOR >200 SECONDS) UNTIL FORCED 
TO GIVE UP ITS ASTE/PT PAIR TO ANOTHER SEGMENT (DEACTIVATION) 
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SEGMENT CONTROL DATA BASES 
ACTIVE SEGMENT TABLE (AST) 

8 THIS DEACTIVATION CONSISTS OF: 

1 MAKING THE SEGMENT INACCESSIBLE TO USER PROCESSES 

0 DONE BY "CUTTING TRAILERS" , IN THE PROGRAM setf aults.pll 

| A LIST OF ALL SEGMENTS CONNECTED TO (USING) THE SEGMENT IS 
KEPT FOR THIS PURPOSE 

1 EVICTING ALL PAGES OF THE SEGMENT FROM MAIN MEMORY 

1 ONLY MODIFIED PAGES MUST BE WRITTEN BACK TO DISK. UNMODIFIED 
PAGES ARE SIMPLY OVERWRITTEN 

0 UPDATING THE VTOCE BY WRITING THE ( POSSIBLY MODIFIED") ACTIVATION 
INFORMATION BACK TO THE VTOCE 

' fl FREEING THE ASTE/PT PAIR 

8 SINCE ACTIVATING /DEACTIVATING SEGMENTS IS EXPENSIVE , THE CHOICE OF 
A SEGMENT FOR DEACTIVATION IS IMPORTANT, AND BELONGS TO THE SEGMENT 
REQUIRING ACTIVATION FURTHEST IN THE FUTURE 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



THE ALGORITHM WHICH CHOOSES A "BEST" SEGMENT FOR DEACTIVATION IS 
IMPLEMENTED IN THE PROGRAM get_aste, AND CONSIDERS SUCH FACTORS AS t 



D THE PRESENCE OF ACTIVE INFERIORS (IF A DIRECTORY) 



THE NUMBER OF PAGES CURRENTLY IN MAIN MEMORY (SINCE WORK IS 
REQUIRED TO EVICT THE MODIFIED FRACTION OF SUCH PAGES AND 
BECAUSE THIS INDICATES "USED RECENTLY" IN SOME SENSE) 



IT LOOKS FIRST FOR A SEGMENT WITH NO INFERIORS, AND NO PAGES IN 
MEMORY , AND ALMOST ALWAYS SUCCEEDS - BUT IF IT FAILS, IT TRIES 
TO MAKE A "GOOD CHOICE", AND DEACTIVATES INFERIORS, AND /OR 
FLUSHES PAGES TO DISK IF NECESSARY 




^ A^r J:r ***** — — 



f.fs-r iv/^n/s ofr .*;r /?;0 

J fact. ^cgs r<xSe ^ 
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TYPICAL "USED LIST" 



A DOUBLE THREADED LIST OF SIMILAR OBJECTS GENERALLY IMPLEMENTING 
REPLACEMENT ALGORITHMS. CONTAINS BOTH FREE AND IN-USE OBJECTS, WITH 
FREE OBJECTS MAINTAINED AT THE HEAD OF THE LIST. 



GO 
O 
> 



SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



NOTE: WHILE INSPECTING THE ASTE'S, OPPORTUNITY IS TAKEN TO NOTICE 
ASTE'S WHOSE FILE MAPS HAVE CHANGED AND , TO UPDATE THEIR VTOCE'S 



0 KNOWN AS "AST TRICKLE" 



0 THIS IS DONE TOTALLY AS A HEDGE AGAINST A FATAL CRASH, AS A 
SUCCESSFUL SHUTDOWN UPDATES ALL VTOCE'S OF ACTIVE SEGMENTS 



0 THIS IS NOT DONE FOR PROCESS DIRECTORY SEGMENTS, SINCE THEIR 
CONTENTS ARE OF LITTLE USE AFTER A CRASH 



0 THE "AST TRICKLE" IS ALSO FORCED TO OCCUR EVERY FIFTEEN MINUTES 
WHEN THE SYSTEM IS LIGHTLY LOADED, BECAUSE OTHERWISE VTOCES 
MIGHT REMAIN UNUPDATED FOR HOURS 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 

8 AST HIERARCHY 

fi MIRRORS A SUBSET OF THE STORAGE SYSTEM HIERARCHY 
g THE ROOT DIRECTORY (>) CANNOT BE DEACTIVATED 



0 NO SEGMENT (EXCEPT THE ROOT) MAY BE ACTIVE UNLESS ITS PARENT IS 
ACTIVE. THE REASONS FOR THIS ARE: 



| PARENT MUST BE ACTIVATED IN ORDER TO FIND THE SON 



ACTIVATION OF OTHER SONS IS EASIER IF THE PARENT REMAINS 
ACTIVE 



THE QUOTA ACCOUNT AGAINST' WHICH AN -ACTIVE SEGMENT'S "RECORDS 
USED" IS TALLIED SHOULD BE IMMEDIATELY AVAILABLE WHEN A 
SEGMENT CHANGES SIZE. THE QUOTA ACCOUNT IS FOUND IN ONE OF 
THE ANCESTORS ' ASTES 



DATE TIME MODIFIED (DTM) FOR A DIRECTORY IS THE DTM OF THE 
LAST MODIFIED SEGMENT IN THE SUBTREE. DTM OF ALL ANCESTOR'S 
SHOULD BE IMMEDIATELY AVAILABLE WHEN A SEGMENT IS MODIFIED. 
DTM IS FOUND IN THE ASTE OF THE ANCESTORS. (USED BY THE 
HIERARCHY DUMPER) 



1 SUCH UPDATES TO THE ASTE'S OF PARENTS ARE PERFORMED BY PAGE 
CONTROL 



| EACH ASTE HAS A POINTER TO ITS PARENT'S ASTE FOR THE ABOVE 
REASONS. (THIS POINTER IMPLEMENTS THE AST HIERARCHY) 
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SEGMENT CONTROL DATA BASES 



ACTIVE SEGMENT TABLE (AST) 



65 ASTE'S MAY BE THREADED ONTO ONE OF SIX LISTS VIA THE RELATIVE 
POINTERS aste.fp and aste.bp 



D FOUR USED LISTS: THREADS ALL FREE AND REPLACEABLE ASTE'S OF 
EACH POOL SIZE ( sst . level . ausedp POINTS TO' THE FIRST FREE ASTE 
IN THE LIST) 



| INIT AND TEMP LISTS: USED AT SYSTEM INITIALIZATION TO RECEIVE 
(AND DELETE) INITIALIZATION AND TEMPORARY SEGMENTS 



B THERE ALSO EXIST SEVERAL AUXILIARY LISTS SUCH AS THE HASH THREAD 
AND FATHER-SON, AND BROTHERS LISTS 



B ALL ACTIVE SEGMENTS IN THE HIERARCHY ARE IN THE FOUR USED LISTS - 
EXCEPT FOR SEGMENTS IN THE HARDCORE PARTITION (THE PAGED 
SUPERVISOR), AND A SMALL CLASS OF SEGMENTS WHICH MAY NOT BE 
DEACTIVATED 



D SEGMENTS ARE SOMETIMES UNTHREADED FROM THEIR USED LIST 
TEMPORARILY IN ORDER TO KEEP THEM OUT OF REACH WHILE SOME 
COMPLEX OPERATION IS PERFORMED 



Not To 3e Reproduced 



7-24 



F80A 



SERVICES OF SEGMENT CONTROL 
CREATING SEGMENTS 

s SEGMENT CREATION IS PERFORMED BY THE PROCEDURE create_vtoce 

0 INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 
0 OUTPUT; PVID AND VTOC INDEX OF THE CREATED SEGMENT 

s create_vtoce MAY BE CALLED BY aDpend (NORMAL SEGMENT CREATION) OR 
segment_mover (DUE TO PACK OVERFLOW) 

a PRINCIPAL STEPS OF create_vtoce : 

8 ' CREATE A LOCAL IMAGE OF THE VTOCE TO BE CREATED 

| FILL IN MOST ACTIVATION AND PERMANENT INFORMATION FROM THE 
BRANCH ENTRY 

A CREATE A NULL FILE MAP 

D DETERMINE THE UID PATH (UID'S OF SUPERIOR DIRECTORIES) 
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SERVICES OF SEGMENT CONTROL 



CREATING SEGMENTS 



SELECT AN APPROPRIATE PV WITHIN THE LV SPECIFIED BY THE 
sons lvid OF THE DIRECTORY IN WHICH THE BRANCH ENTRY APPEARS 



1 SELECTION GOAL IS TO EVENLY DISTRIBUTE SEGMENTS OVER ALL PV S 
OF THE LV, THEREBY REDUCING DISK CONTENTION 



D SELECTION ALGORITHM WALKS THE CHAIN (THROUGH 

pvte.brother_pvtx) OF PV'S IN THE LV AND SELECTS THE PV 

HAVING THE HIGHEST PERCENTAGE OF UNUSED RECORDS IN ITS PAGING 
REGION 



| NO PV IS ACCEPTED IF pvte . vacat i ng IS ON , SIGNIFYING THAT 
sweep_pv IS TRYING TO VACATE, OR INHIBIT CREATION UPON, THE 
PV 



| AN EXCEPTION IS MADE FOR PER PROCESS SEGMENTS 
(entry . per_process IS ON) 

1 SINCE SUCH "SEGMENTS ARE ALL HEAVILY USED, A ROUND ROBIN 
ALGORITHM EVENLY DISTRIBUTES THESE SEGMENTS ACROSS ALL 
PV'S IN THE LV 



INVOKE THE VTOC MANAGER ( vtoc_man$alloc_and_put_vtoce ) TO 
ALLOCATE AND WRITE THE VTOCE IMAGE ON THE SELECTED PV 



I VTOC_MAN ATTEMPTS TO ALLOCATE A VTOCE FROM THE VTOCE STOCK 
FOR THE VOLUME 

| IF THE STOCK IS EMPTY, IT REFILLS IT FROM THE VTOCE MAP ON 
DISK (SEE vtoce_stock_man .pll ) 

| BECAUSE IT IS PERMISSIBLE TO TAKE PAGE FAULTS IN THE 
VTOC_MAN ENVIRONMENT, THE VTOCE STOCK IS ACCESSED WITHOUT 
ANY SPECIAL PAGE CONTROL PROTOCOLS 



| RETURNS THE VTOC INDEX OF THE ALLOCATED VTOCE 
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SERVICES OF SEGMENT CONTROL 



CREATING SEGMENTS 



0 RETURN THE PVID AND VTOC INDEX OF THE NEW SEGMENT TO THE CALLER 
(WHO RECORDS SAME IN entry. pvid AND entry .vtocx) 
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SERVICES OF SEGMENT CONTROL 



SEGMENT ACTIVATION 



a SEGMENT ACTIVATION IS PERFORMED BY THE PROCEDURE "activate" 



| INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 



| OUTPUT: AN ASTE POINTER 



b activate IS PRINCIPALLY CALLED BY seg_fault (OF ADDRESS/NAME SPACE 
MANAGEMENT) WHO HAS LOCATED THE SEGMENT'S BRANCH ENTRY, VALIDATED 
THE USER'S ACCESS, AND CHECKED THE PRESENCE OF THE LV 



» PRINCIPAL STEPS OF activate: 



LOCK THE AST LOCK AND CHECK IF THE SEGMENT IS ALREADY ACTIVE. 
IF SO, UNLOCK THE AST AND RETURN ITS ASTE POINTER 



IF THE SEGMENT IS NOT ACTIVE, UNLOCK THE AST AND READ IN ALL 
REQUIRED PARTS OF THE VTOCE AND COMPARE UID'S FOR CONNECTION 
FAILURE (IN WHICH CASE, DO NOT ACTIVATE AND RETURN AN ERROR) 



D ENSURE THAT THE SEGMENT'S PARENT IS ACTIVE 



THIS IS DONE BY REFERENCING THE PARENT DIRECTORY (PERHAPS 
CAUSING A RECURSIVE SEGMENT FAULT AND ACTIVATION) AND SETTING 
THE aste.ehs BIT FOR IT TEMPORARILY WHILE ACTIVATION IS 
TAKING PLACE 
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SERVICES OF SEGMENT CONTROL 



SEGMENT ACTIVATION 



0 NOTE THAT THE ONLY EXPLICIT ACTION TAKEN TO ACTIVATE THE 
PARENT IS TO REFERENCE IT; THE POSSIBLE RECURSIVE SEGMENT 
FAULT TAKES CARE OF EVERYTHING AND ALLOWS THAT REFERENCE TO 
PROCEED 



0 OBTAIN AN ASTE FOR THE SEGMENT BY CALLING aet_aste. THIS MAY 
INVOLVE DEACTIVATING SOME OTHER SEGMENT - BUT HOPEFULLY NOT THE 
PARENT! (ENSURED BY THE aste.ehs BEING ON) 



J THREAD THE ASTE INTO THE INFERIOR LIST OF THE PARENT'S ASTE 
(THIS WILL KEEP HIM ACTIVE), AND RESET THE PARENT'S aste.ehs 



0 FILL IN THE ASTE WITH THE VTOCE'S ACTIVATION INFORMATION AND 
INITIAL FLAG VALUES 



| CALL pc$f ill_page_table (PASSING THE VTOCE'S FILE MAP) TO 
INITIALIZE THE PAGE TABLE AND OTHER PAGE CONTROL INFORMATION 



fl PLACE THE UID IN THE ASTE AND HASH IT INTO THE AST HASH TABLE 

fl AFTER A SYSTEM FAILURE, ESD USES A ZERO UID AS A CUE THAT THE 

ASTE IS INVALID, AND DOES NOT INVOKE A VTOCE UPDATE FOR THE 
ASTE 
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SERVI CES OF SEGMENT CONTROL 



SEGMENT TRAILERS 



WHEN A PROCESS IS USING A SEGMENT, AND IT HAS A VALID SDW FOR THAT 
SEGMENT, A RECORD MUST BE KEPT IN CASE IT IS NECESSARY TO REVOKE 
THAT SDW (WHEN THE SEGMENT IS DELETED, WHEN THE ASTE IS RE-USED, 
ETC) 



|1 THIS IS DONE BY THE SEGMENT TRAILER MECHANISM 

| EACH PROCESS WHICH HAS A VALID SDW FOR A SEGMENT HAS A 
"TRAILER ENTRY" WHICH RECORDS ITS PROCESS IDENTIFICATION AND 
THE SEGMENT NUMBER IT IS USING FOR THE SEGMENT ^"^N 

| TRAILER ENTRIES ARE KEPT IN THE. Str_seg, A PAGED SUPERVISOR 
SEGMENT 

D THERE IS A LINKED LIST OF TRAILER ENTRIES FOR EACH SEGMENT; 
THE HEAD IS POINTED TO BY aste.strp 



TRAILERS ARE ONLY KEPT FOR SEGMENTS WHICH MAY BE DEACTIVATED 
ORDINARY SEGMENTS AND DIRECTORIES, BUT NOT SUPERVISOR SEGMENTS 



A TRAILER IS ATTACHED FOR A SEGMENT BY seg_f ault . pll BEFORE I' 
PLACES THE SDW INTO THE DSEG FOR THE PROCESS 



TRAILERS ARE USED LATER BY set faults . pll FOR: 

| DEACTIVATION - THE SDW IS ENTIRELY REVOKED (ZEROED) 

D ACCESS CHANGES, DELETION - THE SDW IS MADE INVALID, BUT ITS 
PAGE TABLE ADDRESS IS LEFT UNCHANGED, INDICATING TO 
seg_f ault. pll THAT ALL IT MUST DO IS RECALCULATE THE ACCESS 
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SERVICES OF SEGMENT CONTROL 



SEGMENT TRAILERS 



8 PROCESS TERMINATION - ALL SDWS A PROCESS HAD ARE REVOKED AT 
TERMINATION 



0 CACHE CONTROL - WHEN THE ENCACHAB I L I TY OF A SEGMENT CHANGES, 
THE SDWS WHICH REFER TO IT MUST HAVE THEIR CACHE CONTROL BITS 
UPDATED 



8 TRAILERS . ARE ONLY REMOVED WHEN THE ASSOCIATED SDW IS REVOKED 
COMPLETELY 
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BOUNDSFAULT HANDLING 
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BOUNDS FAULT HANDLING 

1. PAGE FAULT. PAGE 3 "CREATED" IN MAIN MEMORY 
AS A PAGE OF ZEROS (CALLED A "NEW PAGE") 

2. BOUNDS FAULT. PROMOTE THE SEGMENT TO THE 16K 
ASTE/PT POOL-CONTINUE REFERENCE 

AS IN CASE #1 



3. BOUNDS FAULT. ERROR: SIGNAL "out-of-bounds" 
CONDITION 
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SERVICES OF SEGMENT CONTROL 
BOUNDSFAULT HANDLING 



s THE BOUNDSFAULT HANDLER IS THE PROCEDURE " bounds £ a ul t ", INVOKED BY 
THE FAULT INTERCEPTER MODULE, FIM, WHEN THE BOUNDSFAULT IS DETECTED 
BY THE APPENDING UNIT HARDWARE 



b BASIC STEPS OF BOUNDSFAULT 



1 USING THE SEGMENT NUMBER IN THE (SAVED) MACHINE CONDITIONS, FIND 
AND LOCK THE PARENT DIRECTORY, AND FIND THE BRANCH ENTRY 



| LOCK THE AST AND FIND THE SEGMENT'S ASTE VIA 
get_ptrs_$given_segno. IF ATTEMPTED REFERENCE IS BEYOND THE 
MAXIMUM LENGTH (aste.msl) THEN CAUSE "out_of _bounds" TO BE 
SIGNALLED 



D MAKE THE SEGMENT INACCESSIBLE TO USERS BY "CUTTING TRAILERS" 



| TURN ON THE PARENT'S aste.ehs BIT AND CALL get_aste TO OBTAIN A 
LARGER ASTE 



[J CALL PAGE CONTROL'S pc$move_pag eatable TO MOVE ALL ASTE/PT 
INFORMATION TO THE NEW ASTE 



D RETHREAD ALL INFERIOR LIST AND PARENT POINTERS AFFECTED AND TURN 
OFF THE PARENT'S aste.ehs BIT 



| NOTE: IF THE SEGMENT IS A DIRECTORY, ALL FATHER POINTERS OF 
INTERIOR SEGMENTS MUST BE UPDATED 
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SERVICES OF SEGMENT CONTROL 
BOUNDSTAULT HANDLING 

| THIS IS THE ONLY REASON FOR THE EXISTENCE OF INFERIOR LIST IN 
THE AST 

REMOVE THE OLD ASTE FROM THE AST HASH TABLE AND HASH IN THE NEW 
CALL put_aste TO FREE THE OLD ASTE 

UNLOCK THE AST AND RETURN A ZERO STATUS CODE TO THE FIM 
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SERVICES OF SEGMENT CONTROL 



SEGMENT DEACTIVATION 



8 SEGMENT DEACTIVATION IS PERFORMED BY THE PROCEDURE "deactivate" 



| INPUT: POINTER TO AN ASTE 



a deactivate MAY BE CALLED BY: 



get_aste WHEN AN ASTE MUST BE FREED TO MAKE ROOM FOR A NEW 
SEGMENT 



| deiete_vtoce AS PART OF SEGMENT DELETING 



demount_pv IN ORDER TO UPDATE THE VTOCE'S (AND SEGMENTS) OF A 
DISK BEING DEMOUNTED 



a PRINCIPAL STEPS OF deactivate: 



0 MAKE THE SEGMENT INACCESSIBLE TO USERS BY "CUTTING TRAILERS" 



CALL pc$cleanup TO REMOVE ALL PAGES OF THE SEGMENT FROM BULK 
STORE AND MAIN MEMORY, WRITING ALL MODIFIED PAGES TO DISK 
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SEGMENT DEACTIVATION 



8 UPDATE THE VTOCE FROM THE NOW QUIESCENT ASTE 

B THREAD THE ASTE OUT OF PARENT'S INFERIOR LIST, AND OUT OF THE 
AST HASH TABLE 



Q CALL put_aste TO CLEAR AND INITIALIZE THE ASTE/PT PAIR, AND 
THREAD THE ASTE AT THE HEAD OF THE APPROPRIATE USED LIST 
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SERVICES OF SEGMENT CONTROL 
SUMMARY OF MAJOR SERVICES 



1 
8. 

a. 



LOCATION OATA 

• PVID 

• VTOC INDEX 

VERIFICATION OATA 

• UIO 

• UIO OF PARENT 

o DAMAGED SWITCH 

ACCESS CONTROL DATA 

• RING BRACKETS 

• ACL/AIM 

• COPY/SAFETY SWITCH 

• ENTRY POINT BOUND 

• SECURITY BIT 

ATTRIBUTE DATA 

• NAMEiS) 

• AUTHOR 

• BIT COUNT AUTHOR 

• BIT COUNT 

• DIRECTORY BIT 

• PER PROCESS BIT 

• OTEM 



UN-WIRED 
DATA 



WIRED 
DATA 



INITIATION 



( make _ known) 



BRANCH ENTRY DATA 




BRANCH ENTRY DATA 


• UID 




• ENTRY POINT BOUND 


• RING BRACKETS 






• COMPUTED ACCESS 




KSTE DATA 


• DIRECTORY BIT 

• DTEM 


SEGMENT FAULT 


• RING BRACKETS 

• COMPUTED ACCESS 

• PRIVILEGED BIT 


• BRANCH POINTER 


(seg_faurt> 


MAINTAINED DATA 




MAINTAINED DATA 


• SEGMENT NUMBER 




• ADDR OF PAGE TABLE 


• INITIATED COUNT 




• OUT OF BOUNDS 


• PRIVILEGED BIT 




• DIRECTED FAULT BIT 

• UNPAGED BIT 


KSTE 




• CACHE BIT 



TERMINATE 
(terminate) 



SOW 



-J 



BRANCH ENTRY 



LIFE CYCL£ OF A SEGMENT 



3 a 

< 42 

Si 
11 

o 
ffl 



BRANCH ENTRY DATA 

• UIO 

• UIO OF PARENT 

• AIM 

• ORIGINAL NAME 

• DIRECTORY BIT 

• PER PROCESS BIT 

• DN2P BIT 

MAINTAINED DATA 

• FILE MAP 

• CURRENT LENGTH 

• RECOROS USED 

• MAX LENGTH 

• QUOTA DATA 

• USAGE COUNT 

• OTU/DTM/DTC/DTD 

• DUMPER DATA 

• UIO PATH 



ACTIVATION 



(activate) 



DEACTIVATION 



(deactivate) 



AST TRICKLE 



(truncate) 



(get_aste) 



TRUNCATE 



(pcStruncate) 



VTOCE DATA 

• PVT/VTOCE INDICES 

• UID 

• DIRECTORY BIT 

• PER PROCESS BIT 

• DNZP BIT 

t FILE MAP (PT) 
t CURRENT LENGTH 
t RECORDS USED 
T MAX LENGTH 
T QUOTA DATA 
t USAGE COUNT 
t DTU/DTM 

MAINTAINED DATA 

• PHU/PHM BITS 

• WIRED BIT 

• LISTS R_PTR' S 

• HASH TABLE R_PTR 

• SYS TRAILER RJ»TR 

• INFERIOR COUNT 

• EHS/FMC BITS 

• NUM8ER OF PAGES 



VTOCE 



ASTE/PT 

t MAINTAINED VTOCE DATA 
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SERVICES OF SEGMENT CONTROL 



TRUNCATING SEGMENTS 



8 SEGMENT TRUNCATION (IE: PAGE REMOVAL) IS PERFORMED BY THE 
PROCEDURE truncate vtoce 



| INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT , 
AND A PAGE NUMBER FROM WHICH TO START TRUNCATING 



8 truncate vtoce IS CALLED BY: 



| truncate (DIRECTORY CONTROL) WHO HAS LOCATED THE SEGMENTS BRANCH 
ENTRY AND VALIDATED THE USER'S ACCESS 



D delete_vtoce (SEGMENT CONTROL) WHO REQUIRES TRUNCATION (FROM 
PAGE #0) PRIOR TO VTOCE DELETION 



b PRINCIPAL STEPS OF truncate vtoce: 



B IF SEGMENT IS ACTIVE , CALL pc$truncate WHO MARKS THE DEVICE 
ADDRESS OF ALL PAGES ABOVE THE PAGE NUMBER SPECIFIED AS "NULLED " 
ADDRESSES (DISCUSSED IN "PAGE CONTROL" TOPIC) 



| IF SEGMENT IS NOT ACTIVE: 



READ IN ALL REQUIRED PARTS OF THE VTOCE AND COMPARE UID'S FOR 
CONNECTION FAILURE (RETURN AN ERROR IF SO) 
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SERVICES OF SEGMENT CONTROL 



TRUNCATING SEGMENTS 



fl CALL get_pvtx$hold_pvtx TO PREVENT A DEMOUNT (IF CALLED BY 
truncate) 



1 COPY ALL ADDRESSES OF PAGES TO BE TRUNCATED FROM THE FILE MAP 
AND REPLACE THEM WITH "NULL" ADDRESSES 

Q FABRICATE A NEW VTOCE AND WRITE THE VTOCE * BACK BY CALLING 
vtoc_man$put_vtoce 



0 IF ANY REAL ADDRESSES WERE COPIED FROM THE FILE MAP, AWAIT 
THE SUCCESSFUL COMPLETION OF THE VTOCE WRITE BY CALLING 
vtoc_man$await_vtoce 



S CALL pc$deposit_list TO DEPOSIT (FREE) THESE REAL RECORD 
ADDRESSES 



fl CALL get_pvtx$release_pvtx TO AGAIN PERMIT DEMOUNTING (IF 
CALLED BY truncate). THIS CREATES AN ENTRY IN THE PV HOLD 
TABLE (SEE TOPIC 6, VOLUME MANAGEMENT) 
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SERVICES OF SEGMENT CONTROL 



DELETING SEGMENTS 



s SEGMENT DELETION IS PERFORMED BY THE PROCEDURE delete vtoce 



| INPUT: A POINTER TO THE BRANCH ENTRY IN A DIRECTORY SEGMENT 



b delete_vtoce IS CALLED BY delentry (OF DIRECTORY CONTROL FAME) WHO 
HAS LOCATED THE SEGMENT'S BRANCH ENTRY AND VALIDATED THE USER'S 
ACCESS 



Si PRINCIPAL STEPS OF delete_vt oce : 

| CALL get_Dvtx$holc_pvtx TO PREVENT A VOLUME DEMOUNT IN THE 
MIDDLE OF THE DELETION 



I IF ACTIVE, MAKE THE SEGMENT INACCESSIBLE TO USERS (SEE "ADDRESS 
AND NAME SPACE MANAGEMENT" , TOPI C 5 ) 



| TRUNCATE THE SEGMENT TO ZERO LENGTH (SEE "TRUNCATING SEGMENTS " 
IN THIS TOPIC), FREEING ALL DISK, BULK STORE, AND MAIN MEMORY 
PAGES OCCUPIED BY THE SEGMENT 



| IF THE SEGMENT IS A DIRECTORY SEGMENT HAVING A QUOTA ACCOUNT, 
CALL THE QUOTA MOVE PRIMITIVE (quotaw$mq) TO RELINQUISH THE 
QUOTA TO ITS SUPERIOR 
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SERVICES OF SEGMENT CONTROL 



DELETING SEGMENTS 



0 NOTE: DIRECTORY CONTROL IS RESPONSIBLE FOR DELETING ALL 
INFERIOR SEGMENTS BEFORE REQUESTING DELETION OF THE DIRECTORY 
- ENSURING A CONSISTENT HIERARCHY AND RECOVERY OF ALL 
INFERIOR QUOTA ACCOUNTS 



1 IF THE .SEGMENT IS ACTIVE, DEACTIVATE IT, RELEASING ITS ASTE 



I FREE THE VTOCE WITH A CALL TO vtoc_jnan$f ree_vtoce 



1 CALL get_pvtx$release_pvtx TO AGAIN PERMIT VOLUME DEMOUNTING 
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SERVICES OF SEGMENT CONTROL 
OTHER SERVICES 

8 OTHER SERVICES PERFORMED BY SEGMENT CONTROL INCLUDE: 



3 SEGMENT MOVING 

S REQUIRED WHEN AN ATTEMPT IS MADE TO GROW A SEGMENT AND THERE 
IS NO MORE ROOM ON THE PHYSICAL VOLUME 

0 THE ENTIRE SEGMENT MUST BE MOVED TO ANOTHER PV WITHIN THE 
SAME LV TRANSPARENT TO THE USER AND DIRECTORY CONTROL 

| THIS IS THE SINGLE MOST INVOLVED AND ESOTERIC SERVICE OF 
SEGMENT CONTROL 

D SEMI -PERMANENT ACTIVATION 

| ACTIVATING A SEGMENT INTO AN ASTE OF A GIVEN SIZE AND TURNING - 
ON ITS aste.ehs (DONE BY grab__aste) 



D SERVICES FOR sweep_pv 



H LISTING THE VTOC OF A PACK (IE: REPORTING THE PATHNAMES OF 
ALL SEGMENTS OWNING VTOCE'S) 



| THE LOCATING AND DELETING OF ORPHAN VTOCE * S (VTOCE'S NOT 
DESCRIBED IN ANY BRANCH) 



| REBALANCING OR VACATING PACKS VIA DEMAND SEGMENT MOVING 
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SERVICES OF SEGMENT CONTROL 
OTHER SERVICES 

5 SERVICES AT DEMOUNT /SHUTDOWN TIME 
i 

8 DEACTIVATION OF ALL SEGMENTS ON THE VOLUME BEING DEMOUNTED 
AND WRITING OUT THE LABEL , ETC 

1 SERVICES FOR ADDRESS/NAME SPACE MANAGEMENT (SEE TOPIC 4) 

| DESCRIPTOR SEGMENT (DSEG) , PROCESS DATA SEGMENT (PDS) AND 
KNOWN SEGMENT TABLE (KST) MANAGEMENT 

0 SEGMENT FAULT HANDLING ( seg_f ault) , CREATION, ENTRY HOLDING 
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SEGMENT CONTROL METERS 



file svstem meters 



e c 1 LE_SYS T Ef, ME T ERS - D' SPLAYS MISCELLANEOUS METERING I N r ORMA" ' ON 
FOR THE F I LE SYSTEM 



I ONLY PARTS RELEVANT TO SEGMENT CONTROL INCLUDED HERE ; SEE TOP I Z 
8 (PAGE CONTROL) FOR THE REST 



Total metering time 



0:20:02 



op 



- 



J W 1 ' 











ATB " 




Act i vat i ons 


1043 


1. 


153 


sec . 










secf au 1 t 


969 


1 . 


21*1 


sec . 


92. 


905% 


of 


al 1 


makeknown 


74 


16- 


251 


sec . 


7- 


095% 


of 


a i i 


d ; rector i es 


96 


12. 


527 


sec . 


c 


204% 


of 


a", ] 


Deact i vat i or.s 


1056 


1 . 


139 


sec . 










Demand deactivate 


















attempts 


3 


400. 


857 


sec . 










Seg Faults 


5080 


C. 


237 


sec . 










f au i t 


i*3 1 1 


0. 


279 


sec . 


84. 


862% 


of 


Seg Fa w lts 


cal 1 


769 


1 . 


564 


sec . 


15- 


138% 


0* 


Seg Faults 


act i vat i ons 


969 


1 . 


241 


sec . 


19- 


C75% 




Sec Faults 


Bound Faults 


220 


5. 


466 


sec . 










. . r- _ » r _ i «. _ 

JSU fill k& 


1 i C 1 
HHO-t 


Id 0 
'UU' 


1 O 1 
• J * 


mc or 










access 


L2 


28- 


633 


sec . 


0. 


937% 


of 


setf au 1 ts 


ASTE Trickle 


139 


8. 


652 


sec 










Steps 


4279 


281. 


040 


msec . 










Sk i ps 


3016 


r- 

\j . 


399 


sec . 


70. 


■ **84% 


of 


S teps 




271 


u . 


438 


se: . 


6- 


985% 


0** 


Sk i os 


mem \y-> ^or. ^"f" 


1083 


1 . 


1 10 


sec . 


35- 


909% 


of 


S k i v s 


i n i t 


1662 


0. 


724 


sec . 


55- 


. 106% 


of 


Sk i ps 


Searches 


0 


0. 


000 


sec . 










— - C 1 eanups 




1056 




1.139 


sec . 


0.1 


% of real time 


F orce wr i tes 


3 


400. 


857 


sec . 










pages written 


3 


400. 


857 


sec . 










Lock AST 


181*22 


0. 


065 


sec . 











Net To Be Reoroducec 



7-LL 



SEGMENT CONTROL METERS 



file system meters 



AST locked 

AST lock waiting 



AST Sizes 

Number 

Need 

Steps 

Ave Steps 

Lap Time (sec) 



AVE/1 ock / % 
4.833 msec. J 7.4 
1.601 msec. 2.5 



fly loo A* J 0* < ' r sd 



f 1<\ 




4 

1701 
819 
2341 
2.9\ 



16 
601 
202 
645 
3.2 



64 
• 221 
208 
1139 
5.5 
233.3 



256 
74 
34 
154 
4.5 
577.9 



873.8 I 1120.5 

& e ^ ^ 



1 3^ 



CO 



c? r 



I. - 51,7- «A'ad<.o<-/ a,? a > a< ~ K /T(\^. 

rs^ w /,&-« ffP„te . , Ta;^ (T 



\ /"7 



l f * ^ to 3* ^ooj fW 
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SEGMENT CONTROL METERS 



vtoc buffer meters 



e VTOC BUFFER METERS - DISPLAYS VTOC BUFFER MANAGER ACTIVITY 



Toi2 : meter i ng t ime : 

Rout i ne 

get_vtoce 
put_vto*ce 

al loc_anc_Dut_vtoce 
f ree_vtoce 
await vtoce 
GET_BUF F ERS 
WA IT 

Buff e- Al locat iop 



S tecs. 

Skips 
OS 

hot 

wa ; t 



Disk I /OS 



65:21: 12 
# cal Is ATB (sec) 



1346752 
0 

77378 
75664 
93370 
2732265 
946437 



0.17 

0.00 
3.04 
3.H 
2.52 
0.09 



1656952 Hits 



0.25 946435 TC Waits 



( 60.6% of cal Is) 
(100.0% of cal Is) 



? ATB (sec) 



135^279 

27S366 

2LC346 

38518 



0.17 
0.84 
C98 
0.00 
6.11 



20.61% of steps 

86-2% of skiDs 

0.0% of skips 

13-5% of skips 



# A'B(sec) 



Reacs 
Wr i tes 



8365M 
548573 



C.28 
0.43 
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SEGMENT CONTROL COMMANDS 



print aste ptp 
fi PRINT ASTE PTP - DISPLAYS INFORMATION FROM AN ASTE 



ASTE for >udd>Multics>Sibert at 115244 in sst_seg 
077550100664 041540056140 165706076310 102401170050 
315015000063 640000044000 446736250032 446736250272 
003720000000 003164000110 006200006000 073770000102 

uid - 102401170050, vtocx = 63 on pvtx 15 (root4 = dskd_13) 

max len 205, 6 recs used, 0 in core, cur len 6 (decimal) 

Used 03/18/83 0116.0 est Fri 

Modified 03/18/83 0116.2 est Fri 

Par astep = 76310, Son = 56140, brother = 41540 

Trailer thread - 165706 

Aste for a directory. 

Quota (S D) = (2000 0) 

QUsed (S D) = (1652 72) 

Flags: usedf init seg-tqsw fms 



PAGE 


PT 


DEVADD 


0 


063540200041 


63540 


1 


063546200041 


63546 


2 


063547200041 


63547 


3 


063550200041 


63550 


4 


063567200041 


63567 


5 


063571200041 


63571 


6 


377020000001 


null 


17 


377020000001 


null 
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SEGMENT CONTROL COMMANDS 
dump vtoce 



s DUMP VTOCE - READS A VTOCE FROM DISK AND DISPLAYS ITS CONTENTS 



vtoce Sibert (Directory), vtocx 63 on pvtx 15 ( root4 ) -03/18/83 0116.7 est Fri 



Uid = 102401170050, msl/csl/rec = 205 



Quota 
Quota 
Quota 

Created 

Dumped 

Used 

Modi f ied 



(S D) = (2000 0) 

used (S D) = (1423 44) 



received 
08/16/81 
03/18/83 
03/17/83 
03/15/83 



(S D) = 
1204.0 
0106.7 
1737.8 
2138.3 



(2000 0) 
est Sun 
est Fri 
est Thu 
est Tue 



Switches: fm_checksum_valid 
Activation information: 



0 000000000000 102401170050 

4 446723404647 001000400000 

10 002617000054 003720000000 

14 000000000000 000652154327 



315006006000 446734564570 
063560063567 003720000000 
000000000000 015364402005 
446734634556 445673737671 



File map: 

20 063540063546 063547063550 
24 777020777020 777020777020 
30 777776777776 777776777776 



063567063571 777020/77020 
777020777020 777020777020 
777776777776 777776777776 



214 777776777776 777776777776 777776777776 777776777776 



Permanent information: 



220 000000000000 000000000000 000000000000 000000000000 



230 000000000000 000000000000 

234 126104000547 126104000525 

240 777777777777 033022237767 

244 000000000000 000000000000 



260 123151142145 162164040040 

264 040040040040 040040040040 

270 441200557477 135240026001 

274 000000000000 000000000000 



000000000000 446736227316 
126104000764 000000000000 
033023254650 000000000000 
000000000000 000000000000 

040040040040 040040040040 
040040040040 040040040040 
004370027106 000000000000 
000000000000 000000000000 
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Page Control 
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PAGE CONTROL OVERVIEW 



B FUNCTION 



| PAGE CONTROL IS RESPONSIBLE FOR THE MANAGEMENT OF PHYSICAL 
MEMORY TO INCLUDE THE MULTIPLEXING OF MAIN MEMORY FRAMES, AND 
THE MANAGEMENT OF DISK STORAGE 



D ITS TASKS INCLUDE: 

0 TRANSFERRING' THE PAGES OF SEGMENTS BETWEEN THE MEMORY 
DEVICES, AND RECORDING THE LOCATION OF "THE" COPY OF THESE 
PAGES 



D REPORTING THE STATUS AND FILE MAPS OF SEGMENTS TO SEGMENT 
CONTROL 



0 PAGE CONTROL IS LARGELY CODED IN MULTICS ASSEMBLER LANGUAGE 
(ALM) 



PAGE CONTROL CAN BE INVOKED EITHER BY SUBROUTINE CALLS OR BY 
PAGE FAULTS 



Q THERE ARE NO EXPLICIT USER INTERFACES TO PAGE CONTROL 
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PAGE CONTROL OVERVIEW 



S BASIC PHILOSOPHY 



1 OF ALL THE SEGMENTS ACTIVE AT A GIVEN TIME, ONLY A SMALL SUBSET 
OF THEIR TOTAL PAGES WILL BE REQUIRED FOR ACCESSING 



1 PAGES WILL BE READ INTO MAIN MEMORY AS THEY ARE REQUIRED 



THE READING OF A PAGE INTO MAIN MEMORY WILL (PROBABLY) REQUIRE 
THE EVICTION OF A PREVIOUSLY REQUIRED PAGE 



THE CHOICE OF A PAGE FOR EVICTION WILL BE BASED ESSENTIALLY UPON 
A "LEAST RECENTLY USED" CRITERIA 



I AN EVICTED PAGE NEED BE WRITTEN BACK TO DISK ONLY IF IT WAS 
MODIFIED DURING ITS RESIDENCY IN MAIN MEMORY 



E MAJOR DATA BASES 



0 PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM. PROVIDED 3Y 
VOLUME MANAGEMENT 



0 PHYSICAL VOLUME TABLE ENTRY (PVTE) - ONE PER DISK DRIVE 
CONFIGURED 



0 EACH PVTE CONTAINS: 

| THE DEVICE ID (DISK DRIVE ID) AND THE ID OF THE PHYSICAL 
VOLUME (DISK PACK) CURRENTLY MOUNTED 
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PAGE CONTROL OVERVIEW 



8 THE NUMBER OF RECORDS LEFT UNALLOCATED ON THE PHYSICAL 
VOLUME, POINTER TO THE RECORD STOCK, ETC 



B RECORD STOCKS - ONE PER MOUNTED PHYSICAL VOLUME, PROVIDED BY 
VOLUME MANAGEMENT 



0 CONTAINS AN I N-MEMORY CACHE OF THE .IN-USE STATUS OF RECORD§ 
ON THE VOLUME, FROM THE VOLUME MAP, USED WHEN ALLOCATING OR 
FREEING PAGES 

| ACCESSED BY A COMPLEX MECHANISM WHICH USES NORMAL PAGE I/O 
BUT HAS A PROTOCOL TO ENSURE SYNCHRONIZATION OF DISK CONTENTS 
AND RECORD STOCK CONTENTS 



| SYSTEM SEGMENT TABLE (SST) - ONE PER SYSTEM. SHARED WITH 
SEGMENT CONTROL. CONTAINS THE FOLLOWING FIVE DATA BASES USED BY 
PAGE CONTROL: 

fl SYSTEM SEGMENT TABLE (SST) HEADER - ONE PER SYSTEM 

II CONTAINS A LARGE NUMBER OF COUNTERS AND POINTERS VITAL TO 
THE MAINTENANCE AND METERING OF THE STORAGE SYSTEM 

| CONTAINS LOCKWORDS USED TO SYNCHRONIZE PAGE CONTROL AND 
SEGMENT CONTROL OPERATIONS 



fl CORE MAP - THE core_map SEGMENT - ONE PER SYSTEM 

0 CORE MAP ENTRY (CME) - ONE PER FRAME (1024 WORDS) OF 
CONFIGURED MAIN MEMORY 

B EACH CME REPRESENTS A FRAME OF MAIN MEMORY AND IDENTIFIES 
THE CURRENT OCCUPANT OF THAT FRAME 

0 
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PAGE CONTROL OVERVIEW 

NOT PART OF THE SST SEGMENT ANY MORE, BUT LOGICALLY PART 
OF THE SST 

jj ACTIVE SEGMENT TABLE (AST) - ONE PER SYSTEM 

| ACTIVE SEGMENT TABLE ENTRY (ASTE) - ONE PER ACTIVE SEGMENT 
D LIST OF ACTIVE (CURRENTLY BEING USED) SEGMENTS 

| PAGE TABLES (PT) - ONE PER ACTIVE SEGMENT, THE OTHER HALF OF 
EACH ASTE 

I PAGE TABLE WORD (PAGE PTW) - EITHER 4, 16, 64, OR 256 PER 
PAGE TABLE 

| EACH PTW DEFINES THE CURRENT LOCATION OF A PAGE OF THE 
SEGMENT: DISK, MAIN MEMORY ADDRESS, OR NULL 
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PAGE CONTROL TERMINOLOGY 



PAGING: THE PROCESS OF TRANSFERRING PAGES OF DATA BETWEEN DISK 

STORAGE AND MAIN MEMORY (CORE) TO ACHIEVE THE EFFECT OF 
ALL DATA BEING IN MEMORY ALL THE TIME 



CORE: AN OBSOLETE TERM USED FREQUENTLY TO REFER TO MAIN 

MEMORY (WHICH IS MOS TECHNOLOGY, NOT CORE TECHNOLOGY) 



PAGE FAULT: AN EXCEPTION CONDITION DETECTED BY THE PROCESSOR 
HARDWARE (IN THE APPENDING UNIT) WHEN AN ATTEMPT IS 
MADE TO USE A PTW SPECIFYING THAT ITS PAGE IS NOT IN 
MAIN MEMORY 
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PAGE CONTROL DATA BASES 



13 



PAGE TABLES 



of 



1 2 2 2 2 



ADDRESS ! ADD TYPEi! $ | 0 

! T 1 C 




51 s 




•>>>:! P i P > w i C V 0 
C¥:¥J H 1 H j 1 S * f 
W:H M 1 U 1 R , > N 
! P i E . 'Si 0 


, 1 



I 

MAIN MEMORY ADDRESS j 0 0 0 0 


| 1 000 






0 NULL ADDRESS - REPRESENTS PAGE OF ZEROES 


! 0 0 0 0 






WORDS/ 


\ \ 

0(00 


(PTW.INCL.PL Ti 


A 16K PAGE TABLE (FT) 



IMMEDIATELY FOLLOWS AN ASTE I ABOVE i - ONE PER ACTIVE SEGMENT 
COMES IN 4, 16. 64 AND 256K FLAVORS 



b THE PAGE TABLES (PT'S) ARE HARDCORE (SST), UNPAGED, DATA BASES EACH 
CONSISTING OF AN ARRAY OF PAGE TABLE WORDS (PTW'S) 



fl ONE PAGE TABLE PER ACTIVE SEGMENT 

D 4, 16, 64, OR 256 PTW PER PAGE TABLE 
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PAGE CONTROL DATA BASES 



PAGE TABLES 



B ALL PAGE TABLES ARE ASSOCIATED WITH, AND IMMEDIATELY FOLLOW AN ASTE 
IN THE AST REGION OF THE SST 



B EACH PTW DESCRIBES THE STATUS OF ONE PAGE OF THE SEGMENT CURRENTLY 
IN POSSESSION OF THE ASSOCIATED ASTE, INCLUDING: 



1 THE DEVICE ADDRESS OF THE COPY OF THE PAGE 

0 PTW VALID INDICATOR AND FAULT NUMBER (FAULT #1) 

J FLAGS INDICATING VARIOUS STATES AND_ PROPERTIES OF THE PAGE SUCH 
AS I/O IN PROGRESS, WIRED, USED, MODIFIED 



B THE ADDRESS PORTION OF EACH PTW IS INITIALIZED FROM THE SEGMENT'S 
VTOCE FILE MAP AT SEGMENT ACTIVATION TIME 
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PAGE TABLE DEVICE ADDRESSES 



DISK PACK 



,PAGE 1 



0000 J 



000 



PAGE 2 

0 0 0 yvs/x. 0 00 C/w^. 
00^^_-_ju. 0000„ 

OOO^A^. 000- 

"GHOST" PAGE 
OF ZEROES 




r 



DISK RECORD 
"* NUMBER 


4 




NULL 
"* ADDRESS 


0 


« 


MAIN 
- MEMORY 
ADDRESS 


8 





A 4K PAGE TABLE 



I 









> 




a 




w 




o 




o 


> 


2; 


a 


»-3 


w 






O 






> 




w 


a 


t< 


> 


w 


•-3 


in 


>• 




DJ 




> 








W 




CO 



MAIN MEMORY 
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(WORDS) 



CORE MAP ENTRY (CME) 

A HARDCORE DATABASE. LOCATED IN THE 
CORE_MAP SEGMENT. ONE CME PER CONFIGURED 
FRAME OF MAIN MEMORY. 



s THE CORE MAP ISA PERMANENTLY WIRED, UNPAGED, SEGMENT CONTAINING AN 
ARRAY OF CORE MAP ENTRIES (CME'S) 



| ONE CORE MAP PER SYSTEM 



0 ONE CME PER ADDRESSABLE MAIN MEMORY FRAME 



IF THE CONFIGURATION HAS HOLES IN THE MEMORY ADDRESS 
ASSIGNMENTS, OR MEMORIES WHICH ARE TURNED OFF, THOSE CMES ARE 
PRESENT ANYWAY (BUT UNUSED) (0 TO HIGHEST FRAME ADDRESS) 
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PAGE CONTROL DATA BASES 



CORE MAP 



EACH CME DESCRIBES THE STATUS OF ONE PAGE FRAME IN MAIN MEMORY 
INCLUDING: 



1 THE DISK ADDRESS OF THE PAGE CURRENTLY OCCUPYING THE FRAME 



| ADDRESS OF THE ASTE AND PTW OF THE OCCUPANT 



FLAGS INDICATING VARIOUS STATES AND PROPERTIES OF THE FRAME AND 
ITS OCCUPANT SUCH AS I/O IN PROGRESS, NOTIFICATION REQUESTED, 
AND PIN WEIGHT 



THE CME'S ARE KEPT IN A DOUBLE -THREADED CIRCULAR LIST POINTED TO BY 
ssi: . usedo 



LMCj ' b r uk FRAMES UNDERGOING 
THE LIST 



1 CME'S FOR FRAMES CONFIGURED BUT NOT PHYSICALLY PRESENT ARE ALSO 
THREADED OUT BUT WITH THREAD WORD "777777777777" OCTAL 



J THE REMAINING CME'S REPRESENT MAIN MEMORY FRAMES ACTIVELY IN USE 
- AND SUBJECT TO EVICTION BY THE PAGE REPLACEMENT ALGORITHM 
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PAGE CONTROL DATA BASES 
SYSTEM SEGMENT TABLE (SST) HEADER 



B THE FIRST . 512 WORDS OF THE SST IS CALLED THE SST HEADER AND 
CONTAINS: 

D A LARGE NUMBER OF GLOBAL VARIABLES VITAL TO THE OPERATION OF THE 
STORAGE SYSTEM AND ITS SUBSYSTEMS 

1 NUMEROUS CELLS USED TO METER THE STORAGE SYSTEM 

B AMONG THOSE OF INTEREST TO PAGE CONTROL ARE THE FOLLOWING: 

I GLOBAL VARIABLES: 

| PAGE TABLE LOCK (sst.ptl) 

| NUMBER OF MAIN MEMORY FRAMES AVAILABLE FOR PAGING ACTIVITIES 
(sst.nused) AND NUMBER WIRED (sst. wired) 

0 POINTERS TO THE BASE OF THE CME ARRAY AND TO THE' CME OF THE 
"BEST" CANDIDATE PAGE FOR REPLACEMENT 

| PVT INDEX OF THE RPV (USED DURING INITIALIZATION) 
I METERS 

1 THRASHING, POST- PURGE-TIME , PAGE FAULTS ON DIRECTORIES, RING 
0 PAGE FAULTS, LOOP LOCK TIME, SEGMENT MOVES 
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PAGE CONTROL DATA BASES 
SYSTEM SEGMENT TABLE (SST) HEADER 



| PAGING METERS REPORTED BY f ile_system_meters SUCH AS STEPS, 
NEEDS, CEILING, SKIPS 
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PAGE CONTROL DATA BASES 



OTHER DATA BASES 



B ALTHOUGH BASICALLY DATA BASES OF VOLUME MANAGEMENT, THE FOLLOWING 
CONTAIN INFORMATION REQUIRED BY PAGE CONTROL (AS INDICATED) 



B PHYSICAL VOLUME TABLE (PVT) - ONE PER SYSTEM 

8 INFORMATION REQUIRED BY THE DISK DIM FOR I/O 

| INFORMATION USED BY THE DISK RECORD ALLOC ATOR/DEALLOCATOR 
(f reejstore) SUCH AS: 

8 THE NUMBER OF UNALLOCATED RECORDS LEFT ON THE VOLUME 
0 THE LOCATION OF THE RECORD STOCK FOR THE VOLUME 



B RECORD STOCKS 



8 RECORD STOCKS ARE KEPT IN A WIRED SEGMENT: stock_seg 



THE RECORD STOCK FOR A VOLUME IS A LIST OF SOME OF THE RECORDS 
WHICH ARE FREE ON THE VOLUME 



8 WHEN THERE ARE NO MORE ENTRIES AVAILABLE IN THE STOCK, IT IS 
UPDATED FROM THE VOLUME MAP 
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PAGE CONTROL DATA BASES 



OTHER DATA BASES 



| IF THE STOCK BECOMES FULL, SOME OF ITS ENTRIES ARE UPDATED TO 
THE VOLUME MAP AND REMOVED FROM THE STOCK 



(j A COMPLEX MECHANISM (SEE volmap.alm, volma pipage .aim) MAKES 
IT POSSIBLE TO REFERENCE THE VOLUME MAP PAGES WHILE 
SATISFYING A PAGE FAULT 



Not To Be Reproduced 



8-14 



FBOA 



SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



B WITHIN ANY DEMAND PAGING ENVIRONMENT THE CHOICE OF WHICH PAGE TO 
EVICT IS CRUCIAL TO SYSTEM PERFORMANCE 



S ONE OF THE BETTER CHOICES FOR EVICTION IS THE "LEAST RECENTLY USED" 
PAGE.... OR (BECAUSE OF EFFICIENCY), THE "LEAST RECENTLY NOTICED AS 
BEING USED" PAGE. 



B THE MULTICS PAGE REPLACEMENT ALGORITHM (PRA) , KNOWN IN THE 
LITERATURE AS THE "CLOCK" ALGORITHM WAS ONE OF THE FIRST EVER TO BE 
IMPLEMENTED 



B THE VERSION AS IT EXISTS TODAY IS A DIRECT DESCENDANT OF Corbato's 
ORIGINAL ALGORITHM (SEE SECTION 5 OF THE "MULTICS STORAGE SYSTEM 
PLM" , AN61, FOR A BIBLIOGRAPHY) 



B PAGES ARE KEPT IN A CIRCULAR LIST, THE CORE USED LIST, IMPLEMENTED 
BY. THE DOUBLY THREADED CME'S 



B A POINTER, MAINTAINED IN THE SST, (sst.usedp) POINTS TO THE LOGICAL 
HEAD OF THIS LIST AS FOLLOWS: 
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SERVICES OF PAGE CONTROL 




THE CLOCK ALGORITHM 



1. THE "REPLACER" SEARCHES FOR THE FIRST PAGE WHICH IS NEITHER WIRED NOR 
MODIFIED, AND HAS NOT BEEN USED SINCE LAST INSPECTED, MAKING THAT PAGE 
IMMEDIATELY AVAILABLE TO THE REQUESTOR. 

2. THE "PURIFIER" THEN CATCHES UR INITIATING WRITES FOR ALL "NOT USED-BUT 
MODIFIED" PAGES PASSED OVER BY THE "REPLACER" AND TURNING OFF THE USED 
FLAG FOR ALL USED PAGES. 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



B PAGE FAULT HANDING IS THE MOST VISIBLE AND CRUCIAL SERVICE OF PAGE 
CONTROL 



fi A PAGE FAULT OCCURS WHEN A USER REFERENCES A PAGE OF SOME SEGMENT 
THAT IS NOT IN MAIN MEMORY 



I OR MORE SPECIFICALLY: HARDWARE ATTEMPTS TO USE A PTW THAT 
INDICATES ITS PAGE IS NOT IN THE MAIN MEMORY 



a PAGE FAULT HANDLING IS IMPLEMENTED IN THE ALM PROGRAM page_fault 
WHICH IS INVOKED DIRECTLY BY THE FAULT VECTOR CODE (page_fault LS 

nrr ttt> rum m t lTmpnorrimAn m/-\T-> n» m n ttt mr» \ """* ~~~~ 



B THE PRINCIPAL STEPS OF page_fault ARE: 



0 SAVE ALL MACHINE CONDITIONS, MASK AGAINST INTERRUPTS, AND 
ESTABLISH A STACK FRAME ON THE BASE OF THE PROCESSOR DATA 
SEGMENT (PRDS), WHICH IS USED AS THE STACK FOR INTERRUPTS AND 
PAGE FAULTS 



8 CHECK FOR ILLEGAL CONDITIONS AND CRASH IF SO 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



ATTEMPT TO LOCK THE PAGE TABLE LOCK (sst.ptl) AND WAIT IF 
UNSUCCESSFUL 



LOCATE THE RESPONSIBLE PTW AND ITS ASTE. THIS IS OFTEN THE MOST 
DIFFICULT TASK 



| IT IS DIFFICULT BECAUSE IT REQUIRES FETCHING THE SDW FROM THE 
DSEG , WHICH IS, ITSELF, PAGED, AND NOT GUARANTEED TO BE IN 
MEMORY 



CHECK FOR TWO WINDOW SITUATIONS INVOLVING SOME OTHER PROCESS 
HANDLING A PAGE FAULT FOR THE SAME PAGE: 



| IF PAGE IS NOW IN, THEN UNLOCK THE LOCK AND RESTART THE 
MACHINE CONDITIONS 



11 IF PAGE IS BEING READ IN NOW, DEVELOP THE WAIT EVENT FOR THE 
PTW AND SKIP THE NEXT THREE STEPS 



INVOKE read_page TO FIND THE LEAST RECENTLY (NOTICED AS BEING) 
USED MAIN MEMORY FRAME, BEGIN THE PAGE-READING FUNCTION, AND 
DEVELOP THE WAIT EVENT 



EXECUTE THE REPLACEMENT ALGORITHM'S WRITE-BEHIND (PURIFIER) 
FUNCTION, CAUSING PASSED OVER WRITE REQUESTS TO BE QUEUED 



METER THE PAGE FAULT TO INCLUDE: TIME SPENT; MAIN MEMORY USAGE 
OF THIS PROCESS; RING ZERO, DIRECTORY, AND PER-PROCESS FAULTS 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 



g TRANSFER TO THE TRAFFIC CONTROLLER, WHO PLACES THE PROCESS IN 
THE WAIT STATE, UNLOCKS THE PAGE TABLE LOCK, AND ABANDONS THE 
ENVIRONMENT (SEE "TRAFFIC CONTROL", TOPIC 10) 



8 WHEN THE PAGE READING I/O IS COMPLETE, THE EVENT WILL BE POSTED. 
THE WAITING PROCESS WILL BE GIVEN THE PROCESSOR AGAIN AND TRAFFIC 
CONTROLLER WILL TRANSFER THE FAULTING PROCESS TO 

page_fault$wait_return TO RESTART THE MACHINE CONDITIONS 
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PAGE FAULT HANDLING 
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PAGE FAULT SCENARIO 

SCENE 1; AFTER SEGMENT ACTIVATION 

1. ASTE/PT PAIR FREED AND ALLOCATED TO SEGMENT A 

2. VTOCE'S ACTIVATION DATA COPIED INTO ASTE 

3. VTOCE'S FILE MAP DATA COPIED INTO PTW 



IN O 
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SERVICES OF PAGE CONTROL 



PAGE FAULT HANDLING 
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PAGE FAULT SCENARIO 

SCENE 2: AFTER PAGE FAULT ON PAGE NO.2 

1. FRAME 3702 FREED AND ALLOCATED TO PAGE NO. 2 

2. PAGE NO. 2 COPIED INTO FRAME 3702 

3. ADDRESS IN PTW NO. 2 COPIED TO CME 3702 

4. ADDRESS IN PTW NO. 2 REPLACED WITH MAIN MEMORY ADDRESS 
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PAGE FAULT SCENARIO 

SCENE 3: AFTER PAGE FAULT ON PAGE NO. 1 



1. FRAME 5614 FREED AND ALLOCATED TO PAGE NO. 1 

2. FRAME 5614 ZEROED BECAUSE OF PTW NO.I's NULL ADDRESS 

3. RECORD 2103 ALLOCATED TO PAGE NO.1 

4. ADDRESS FOR RECORD 2103 WRITTEN INTO CME 5614 AS A NULLED ADDRESS 
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PAGE FAULT HANDLING 
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PAGE FAULT SCENARIO 

SCENE 4A: PAGE NO.1 (UNMODIFIED) EVICTED FROM MAIN MEMORY 

1. NULLED ADDRESS IN CME 5614 COPIED TO PTW NO.1 

2. CME 5614 FREED 
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PAGE FAULT SCENARIO 

SCENE 5A: AFTER SEGMENT DEACTIVATION 

1. PAGE NO. 2 EVICTED FROM MAIN MEMORY AFTER ADDRESS IN CME 3702 COPIED TO PTW NO. 2 

2. PTW ADDRESSES WRITTEN TO VTOCE FILE MAP WITH NULLED ADDRESS IN PTW NO. 1 
CONVERTED TO A NULL ADDRESS 

3. RECORD 2103 FREED 

4. ASTE/PT PAIR FREED 
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PAGE FAULT SCENARIO 

SCENE 4B: PAGE NO.I(MODIFIED) EVICTED FROM MAIN MEMORY 
(AND DISK I/O KNOWN TO BE COMPLETE) 



1. FRAME 5614 WRITTEN TO RECORD 2103 

2. NULLED ADDRESS IN CME 5614 RESURRECTED AND COPIED TO PTW NO. 1 

3. CME 5614 FREED 
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SERVI CES OF PAGE CONTROL 



PAGE FAULT HANDLING 
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FRAMES 



PAGE FAULT SCENARIO 

SCENE 5B: AFTER SEGMENT DEACTIVATION 



1. PAGE NO. 2 EVICTED FROM MAIN MEMORY 

2. PTW ADDRESSES WRITTEN TO VTOCE FILE MAP 

3. ASTE/PT PAIR FREED 
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POST PURGING 



a POST PURGING IS PERFORMED BY THE PROCEDURE postjpurge 



3 POST PURGING IS AN OPTIONAL SERVICE USED TO OPTIMIZE THE PAGE 
REPLACEMENT ALGORITHM 



53 POST PURGING: 



FAVORS THE REPLACING OF PAGES USED BY A PROCESS WHICH HAS JUST 
LOST ELIGIBILITY (SEE "TRAFFIC CONTROL", TOPIC 9) 



|J IS A WORK CLASS SETTABLE ATTRIBUTE 



POST PURGING IS LARGELY USELESS TODAY, BECAUSE MAIN MEMORY SIZE IS 
SO MUCH GREATER 
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PAGE CONTROL METERS 
file system meters 



® FI LE_SYSTEM_METERS - DISPLAYS MISCELLANEOUS METERING INFORMATION 
FOR THE FILE SYSTEM 



| ONLY PARTS RELEVANT TO PAGE CONTROL INCLUDED HERE; SEE TOPIC 7 
(SEGMENT CONTROL) FOR THE REST 




ON 



Total metering time 



62654 



0:20:02 



ATB 



Needc 

Ring 0 faults 
PDIR faults 
-Level 2 faults 
DIR 'fault s-OVu^-f 
New Pages- *W ***»i> 14 . 661 



19.194 msec. 
16.639 % 
50.607 % 
21.556. % 
7.645 % 
% 




Volmap_seg 0 

Zero pages 770 

Laps 105 

Steps 361483 

Skip 322555 

wired 11057 

used 109719 

mod 140336 

fc pirOps* 37717 

cl pinj"*'"* 23726 

3419 pages, 139 wired. 

Average steps 5 



0.000 msec. 
1561.779 msec-r^-^ of ev!,cT 
11.453 sec . twowA cW^ 

3 .327 -msec . 

3.728 msec. 
108.761 msec. 
10.960 msec. 

8.569 msec. 
31.884 msec. 
50.686 msec. 



89.231% of Steps 

3.428% of Skip 

34.016% of Skip 

43.508% of Skip 

11.693% of SkiD 

7.356% of Skib 



770 



f^vof P^xi^S ^/ @Y 
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TRAFFIC CONTROL OVERVIEW 



B FUNCTION 



Q TRAFFIC CONTROL (OR THE "TRAFFIC CONTROLLER") IS RESPONSIBLE FOR 
MANAGING THE ASSIGNMENT OF PHYSICAL PROCESSORS TO MULTICS 
PROCESSES AND IMPLEMENTING THE SYSTEM'S WAIT/NOTIFY AND 
INTERPROCESS COMMUNICATION PRIMITIVES 



0 THE FUNCTIONS ASSUMED BY THE TRAFFIC CONTROLLER ARE KNOWN AS 
MULTI PROGRAMMI NG , MULT I PROCESS I NG , SCHEDULI NG, DI SPATCHI NG , 
PROCESSOR MANAGEMENT, AND INTERPROCESS COMMUNICATION. 



| ITS MAJOR FUNCTION IS ALLOWING PROCESSES TO AWAIT THE COMPLETION 
OF FILE SYSTEM OPERATIONS, SUCH AS PAGE I/O 



1 TRAFFIC CONTROL CAN BE INVOKED BY SUBROUTINE CALLS AND 
INTERRUPTS 



0 THERE ARE NO IMPORTANT USER SUBROUTINE INTERFACES , BUT THERE ARE 
PRIVILEGED SUBROUTINE INTERFACES FOR PROCESS CREATION, 
ADJUSTMENT OF SCHEDULING PARAMETERS, ETC. 



8 MAJOR DATA BASES 



TC_DATA SEGMENT - ONE PER SYSTEM. CONTAINS THE FOLLOWING FOUR 
DATA BASES: 



1 TC_DATA HEADER - ONE PER SYSTEM 

| CONTAINS VARIOUS METERS, COUNTERS AND POINTERS USED BY THE 
TRAFFIC CONTROLLER 
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TRAFFIC CONTROL OVERVIEW 



ACTIVE PROCESS TABLE (APT) - ONE PER SYSTEM 

1 ACTIVE PROCESS TABLE ENTRY (APTE) - ONE OCCUPIED PER 
ACTIVE PROCESS (TOTAL NUMBER IS DETERMINED BY CONFIG DECK) 

| EACH APTE CONTAINS VARIOUS ATTRIBUTES OF AN ACTIVE PROCESS 
INCLUDING THE PROCESS ID, STATE, THE VALUE OF ITS 
DESCRIPTOR BASE REGISTER (DBR) , SCHEDULING PARAMETERS, AND 
* A POINTER TO THE PROCESS'S ITT ENTRIES 

(j THE APTE CONTAINS ALL INFORMATION THE SUPERVISOR NEEDS TO 
KNOW ABOUT A PROCESS WHEN THE PROCESS IS NOT RUNNING 



INTERPROCESS TRANSMISSION TABLE (ITT) - ONE PER SYSTEM 

D ITT ENTRY - ONE OCCUPIED PER OUTSTANDING IPC WAKEUP 

I A QUEUE FOR TEMPORARILY STORING IPC WAKEUP INFORMATION 
(CHANNEL NAME, RANDOM DATA, PROCESS ID, ETC) 



WORK CLASS TABLE (WCT) - ONE PER SYSTEM 

D WORK CLASS TABLE ENTRY (WCTE) - ONE PER WORKCLASS 

0 EACH WCTE CONTAINS ADMINISTRATOR DEFINED PARAMETERS OF THE 
WORKCLASS, VARIOUS METERS AND POINTERS 
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TRAFFIC CONTROL TERMINOLOGY 



PROCESS : 

AN ADDRESS SPACE AND AN EXECUTION POINT WITHIN THAT 
ADDRESS SPACE 



MULT I PROGRAMMI NG : 

PERTAINING TO THE CONCURRENT EXECUTION OF TWO OR MORE 
PROGRAMS BY INTERLEAVING THEIR EXECUTION 



MULTIPROCESSING: 

PERTAINING TO THE SIMULTANEOUS EXECUTION OF TWO OR MORE 
PROGRAMS BY A MULTIPROCESSOR SYSTEM (PARALLEL 
PROCESSING) 



ELIGIBLE: 

AN ADJECTIVE DESCRIBING THOSE PROCESSES ACTIVELY 
COMPETING FOR A FRCCI 
ELIGIBLE OR INELIGIBLE 



SCHEDULING 



PERTAINS TO THE ACT OF CHOSING AND PROMOTING AN 
"INELIGIBLE" PROCESS TO "ELIGIBLE" STATUS 



DISPATCHING: ^ 

PERTAINS TO THE ACT OF CHOSING AND PLACING AN ELIGIBLE 
PROCESS IN THE "RUNNING" STATE (IE: EXECUTING 
INSTRUCTIONS ON A PROCESSOR) 
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TRAFFIC CONTROL TERMINOLOGY 



WORK CLASS: A WELL DEFINED SET OF USERS ( USUALLY CONSISTING 

OF ONE OR MORE PROJECTS) HAVING COMMON PERFORMANCE 
PARAMETERS. THE USER COMMUNITY MAY BE DIVIDED INTO NO 
MORE THAN 16 WORK CLASSES 



WORKING SET: (."©« «» ^ of r***«( ^ c*re \ ^ "*Hf 

THE SET OF PAGES A PROCESS TOUCHES DURING A GIVEN 

INTERVAL. THE SIZE OF A CURRENT WORKING SET "IS 
PREDICTIVE OF FUTURE MEMORY REQUIREMENTS 



for 




J 












El* 




IN %\ \6 









<, fW s*s 95^ VvirJ&n^ 

YOv^ 4(3 foK. 0**? y>" uif ^ /V "iffy. 



VCvu - <:Po fc/M -to 
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OA 



TRAFFIC CONTROL DATA BASES 
TC DATA 



tc data HEADER 



WORK CLASS TABLE (WCT) 
(0:16) 



ACTIVE PROCESS TABLE (APT) 
( 0:CONFIGURED ) 



INTERPROCESS TRANSMISSION TABLE (ITT) 
( 0:CONFIGURED ) 



TC.DATA 

A WIRED DATA BASE - ONE PER SYSTEM 
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TRAFFIC CONTROL DATA BASES 



TC DATA 



1111111111222:222222333333 

01234SS78901234SS789ei23«S67«90l23«S 



FORWARD R PTR 



BACKWARD R PTR 



S : a I T ! e 



« I A j I I L 



OjPjsj E E I 



T I P I ■ I • I 



EXECUTION STATE 



NUMBER OF PAGE FAULTS 



PROCESS IDENTIFIER 



TIME HAS BEEN ELIGIBLE (TE) 



TIME SINCE Tl CHANGED (TS) 



TIME SINCE LAST INTERACTION fTI! 



MAXIMUM VALUE FOR Tl (TIMAX) 



IPC EVENT THREAD 



IPS MESSAGED) 



R PTR TO ASTE OF POS 



R_PTR TO ASTE OF DSEG 



R_PTR TO ASTE OR PRDS (WHILE RUNNING) 



EXECUTION POINT (IN TRAFFIC CONTROL) 



PROCESS IDENTIFIER TO NOTIFY ON TERMINATION 



LOCK IDENTIFIER 



CPU TIME USED 



WAIT EVENT 



WORK CLASS TABLE INDEX 



SP WAKEUPS 



|j a ' PR TAG 



TIME OF LAST STATE CHANGE 
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TRAFFIC CONTROL DATA BASES 



TC DATA 



20 
21 



MAKEUP EVENT FOR ALARM CLOCK MANAGER 



22 ALARM TIME THREAD 

23 



ALARM TIME 



24 

25 



EVENT CHANNEL TO NOTIFY ON PROCESS TERMINATION 



26 WORKING SET ESTIMATE 



27 MAXIMUM VALUE FOR TE ITEM AX) 

28 

OEAOLINE SCHEDULING TIME 

29 



30 APTE LOCK 



31 CPU MONITOR 

32 



PAGING MEASURE 



ACCESS ISOLATION MECHANISM (AIMI CLASS 



DESCRIPTOR BASE REGISTER VALUE (DBRI 



VIRTUAL CPU TIME 



40 ITT MESSAGES SENT AND NOT READ OUT 



ITT MESSAGES RECEIVED AND NOT READ OUT 



8 WORDS FOR RESPONSE TIME METERING 



SO SAVED VALUE OF TEMAX 



PROCS REQUIRED [: 

L 



1 



12 WORDS OF PADDING (TO 64 WORDS) 

ACTIVE PROCESS TABLE (APT) 

A HARDCORE (tc.Oatai DATA BASE - ONE PER SYSTEM 
CONSISTS OF AN ARRAY OF APTE'S AS ABOVE 

ACTIVE PROCESS TABLE ENTRY APTE: 

ONE PER ACTIVE PROCESS 
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SERVICES OF TRAFFIC CONTROL 
WAIT LOCKS 



WAIT LOCKS 





WAIT 




EVENT 





ADD 




EVENT 



NOTIFY 
EVENT 



LT 



DELETE 
EVENT 
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SERVICES OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 



» SINCE THE NUMBER OF ACTIVE PROCESSES GENERALLY EXCEEDS THE NUMBER 
OF PROCESSORS (OFTEN 50:1) THE PROCESSORS MUST BE MULTIPLEXED 



as PROCESSOR MULTIPLEXING IS THE PRIMARY RESPONSIBILITY OF THE TRAFFIC 
CONTROLLER 



B THE MULTICS ARCHITECTURE DICTATES THE FOLLOWING AXIOMS: 



g ALL PROCESSORS ARE SYMMETRICAL 



D AN INTERRUPT IS SEEN BY ALL PROCESSORS AND IS SERVI CED BY THE 
PROCESSOR THAT CLAIMS IT FIRST 

| NOT ACTUALLY TRUE, DUE TO HARDWARE CONNECTION LIMITATIONS 



fl THERE ARE NO MASTER OR SLAVE PROCESSORS. ONLY A PROCESSOR 
DESIGNATED TO PERFORM BOOTLOAD AND SHUTDOWN (THE "BOOTLOAD 
PROCESSOR" ) 

3 BOOTLOAD PROCESSOR CAN BE CHANGED AT ANY TIME BY DYNAMIC 
RECONFIGURATION 



i A PROCESSOR MAY BE "IN" AT MOST ONE PROCESS AT A TIME 



D A PROCESS MAY EXECUTE ON ONE AND ONLY ONE PROCESSOR AT A TIME. 
THE PROCESS MAY, HOWEVER, "RANDOMLY" MIGRATE FROM ONE PROCESSOR 
TO ANOTHER 
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SERVICES OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 



| A PROCESSOR WILL , AT ALL TIMES, BE "IN" A PROCESS 



B PROCESSES MAY EXIST IN ONE OF SIX STATES - ONE OF WHICH IS 
"RUNNING" (IE: EXECUTING ON A PROCESSOR) 



s> THE TRAFFIC CONTROLLER CODE PERFORMS ALL STATE CHANGES. THE STATE 
CHANGES FALL INTO TWO CATEGORIES: SELF IMPOSED AND EXTERNALLY 
IMPOSED. 



D SELF IMPOSED STATE CHANGES (THE PROCESS MUST HAVE A PROCESSOR) 

I RUNNING -> READY (#1 -> #2) 

| THE PROCESS WAS TOLD (BY EITHER A CONNECT FAULT FROM 
ANOTHER PROCESSOR OR A TIMER RUNOUT)"- TO GIVE UP ITS 
PROCESSOR 

I THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 



| RUNNING -> WAITING (£1 -> #3) 

0 THE PROCESS ISSUED A REQUEST FOR A "SYSTEM EVENT" (EG: A 
PAGE FAULT OR A WAIT LOCK) 

[] "SYSTEM EVENTS" OCCUR AFTER A PREDICTABLY SHORT PERIOD OF 
TIME AND ARE HANDLED BY THE WAIT/NOTIFY MECHANISM 

1 THE PROCESS IS NOW WAITING FOR A NOTIFY INDICATING THE 
COMPLETION OF THE EVENT (EG: THE ARRIVAL OF THE PAGE IN 
MAIN MEMORY) 
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SERVICES OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 



8 RUNNING -> PAGE TABLE LOCK WAITING (#1 -> #6) 

8 THE PROCESS ATTEMPTED TO LOCK THE PAGE-TABLE LOCK AND 
FOUND IT ALREADY LOCKED 

8 THE PROCESS IS NOW WAITING FOR A NOTIFY INDICATING THE 
UNLOCKING (A SYSTEM EVENT) 



8 RUNNING -> BLOCKED (#1 -> #4) 

8 THE PROCESS ISSUED A REQUEST FOR A "USER EVENT" (EG: A 
READ FROM THE TERMINAL) 

8 "USER EVENTS " OCCUR AFTER A PREDICTABLY LONG PERIOD OF 
TIME AND ARE HANDLED BY THE BLOCK/WAKEUP MECHANISM 

1 THE PROCESS IS NOW WAITING FOR A WAKE_UP INDICATING THE 
COMPLETION OF THE EVENT (EG: A LINE_FEED GENERATES A 
WAKE_UP) ARE HANDLED BY THE BLOCK/WAKE JJP MECHANISM 

fl A PROCESS GOING BLOCKED GIVES UP ITS RING ZERO STACK 



8 RUNNING -> STOPPED (#1 -> #5) 

fl THE PROCESS EXECUTED THE logout OR new_proc COMMAND, 
EVENTUALLY CALLING hcs_$stop_process 

8 THE PROCESS IS PROHIBITED FROM RUNNING AGAIN AND WILL 
QUICKLY BE DESTROYED BY THE INITIALIZER 



Not To Be Reproduced 



9-11 



F80A 



SERVICES OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 



| EXTERNALLY IMPOSED STATE CHANGES (THE STATE IS CHANGED BY 
ANOTHER PROCESS) 



0 READY -> RUNNING (#2 -> #1) 

0 THE PROCESS (WHICH WAS WAITING FOR NO OTHER RESOURCE THAN 
A PROCESSOR) WAS CHOSEN AS SUCCESSOR BY A PROCESS 
RELINQUISHING A PROCESSOR 

S THE PROCESS IS NOW EXECUTING 



BLOCKED -> READY (#4 ~> £2) 

| SOME OTHER PROCESS SENT A WAKEUP INDICATING THE COMPLETION 
OF THE EVENT THIS PROCESS WAS WAITING ON, AND CHANGE THE 
STATE OF THIS PROCESS 

D THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 



| WAITING ~> READY (#6 -> #2) 

PTL-WAITING ~> READY (#3 -> #2) 

| SOME OTHER PROCESS SENT A NOTIFY INDICATING THE COMPLETION 
OF THE EVENT THIS PROCESS WAS WAITING ON, AND CHANGED THE 
STATE OF THIS PROCESS 

| THE PROCESS IS NOW WAITING FOR NO OTHER RESOURCE THAN A 
PROCESSOR 
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J) locked ' Ar i~cW7/,^ 

TRAFFIC CONTROL STATES 




ELIGIBLE PROCESSES (13) INELIGIBLE PROCESSES (87) 



* ALL FIGURES ARE BASED ON METERS FROM A 100 USER. 3 CPU. 2.5M MEMORV. MAXE = 16 SYSTEM. 



SERVICES OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 

TRAFFIC CONTROL SCENARIO 

SCENE 1: CPU "C" TAKES AN INTERRUPT 



Jones.ProjA 

B x 



1. EVENT 3331 OCCURES. 
CPU "C" TAKES THE 
INTERRUPT AND STORES 
MACHINE CONDITIONS 



2. May.FOI NOTIFIES 

Kelly. EREG BY CHANGING 
HIS STATE TO READY (r) 



May.FOI CALLS get-processor 
WHICH LOOKS FOR AN 
EXECUTING (x) PROCESS 
LOWER THAN Kelly.EREG, 
FINDS IDLE_A, AND 
SENDS CPU "A" A CONNECT 
FAULT (cioc INSTRUCTION) 



4. May.FOI RESUMES PRIOR 
ACTIVITY BY RESTORING 
MACHINE CONDITIONS 




Green.MMPP 



00 



CO 
CO 
LU 

o 
u 

D 

CO 

LU 
CD 
> 
< 
2 



ldle_A 

A 


X 






ldle_B 


r 






Idle C 


r 



CIOC 
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SERVICES OF TRAFFIC CONTROL 
PROCESSOR MULTIPLEXING 



TRAFFIC CONTROL SCENARIO 

SCENE 2: CPU "A" RECEIVES CONNECT FAULT 



3. 



CPU "A" RECEIVES CON- 
NECT FAULT AND STORES 
MACHINE CONDITIONS 



ldle_A BEGINS PRE-EMPTION 
BY CHANGING STATE TO 
READY (r) 



ldle_A CALLS get-work 
WHICH LOOKS FOR THE 
HIGHEST READY (r) 
PROCESS, FINDS Kelly. ER EG, 
CHANGES HIS STATE TO 
EXECUTING (x) AND CPU 
TAG TO "A", AND LOADS 
HIS DBR 



Jones.ProjA 
B 


X 






Smith. FED 
1043 


w 






May.FOI , 

C 1 x 






White. FED 
1662 


w 






Keily.EREG | 

i r 1 






Green.MMPP 


r 



o 
5 

00 



Keily.EREG RESUMES 
PRIOR ACTIVITY BY 
RESTORING MACHINE 
CONDITIONS 




u. 

CO 
CO 
LU 
e > 

u 

D 

CO 
CO 

> 
< 

-J 

< 

CO 



ldle_C 
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o 

rt 

O 

W 
(D 

CO 

o 

Oi 

c 
n 

CD 



VD 
I 



WORKING SETS AND PAGE THRASHING 



PAGE 

REFERENCE 
STRING 



CASE # 1 : 
MINIMAL. 
PAGE 
FAULTS 



CASE #2: 
UNNECESSARY 
PAGE 
FAULTS 



AB A CDA CDB E FCD CDFE FED GF 



D A ©@ A CDB (§) ® C D CEFE FED ©F 



(7 PAGE FAULTS! 



@® A ©@A C D(|) ® ®(|)d CEFE FE(|)©F 



t 



N 



(10 PAGE FAULTS! 
TIME 



WORKING SET = 7 PAGES 

• CASE #: 1 : THRASHING 





in 




W 




id 


t*J 


< 


o 


i — i 


o 


o 


w 


w 


in 


to 


in 




O 


1° 








TR 




>• 


•-3 


•n 




►*j 




i— i 


It* 


o 


m 






o 


it 


o 


Z 




o 


»-3 








O 




tr 1 



H = 0% 



• CASE ■# 2 : THRASHING = 



— = 30% 
10 



CXJ 

o 



SERVI CSS OF TRAFFIC CONTROL 



PROCESSOR MULTIPLEXING 



IDLE CATEGORIES 



ZERO 
IDLE 



|\Joy\ VAoVT^^at— 
dj. NMP 



Wouli Ucf &*<n LOADING 
vs?<5f By' So^eo^ fi*- r IDLE 
T^py f) x - 0y\>T Vovi 

*(«\»C>1«- , DLE 

CPu . WORKCLASS 

to v*\S T w IDLE 



ELIGIBLE 


NOT ELIGIBLE . 


RUNNING 


WAITING 


READY 


READY 


READY, BUT 
i iv uvcnuocu 
WORKCLASS 


0 


0 


0 


0 


0 


1 
0 

1 


1 
2 
0 


0 
0 
0 


0 
0 
0 


0 
0 
0 


1 


2* 


0 


0 


0 


1 
0 


2 
3 


0 
0 


>0 
>0 


=?o 


1 

0 

1 


1 
2 
0 


0 
0 
0 


0 
0 
0 


>0 
>0 
>0 



I*/* fr.c^ Be,^ [^J Q> 



Not To Be Reproduced 



9-17 



TRAFFIC CONTROL METERS 



total time meters 



TOTAL_TIME_METERS - OVERVIEW OF HOW THE SYSTEM 
RESOURCES, ALSO MEASURED AGAINST NON-IDLE TIME 



IS USING ITS 



km 



or 



Total metering time 




Page Faults 

PC Loop Locks 
PC Queue 
Seg Faults 
Bound Faults 
Interrupts 
Other Fault 
CGetwork 
\ TC Loop Locks 
vPost Purging 
MP Idle 

Work Class Idle 
Loading Idle 
NMP Idle 
Zero Idle 
Other Overhead 
Virtual CPU Time 



0:20:36 
%NI 



tor 



7.19 
0.43 
0.94 
1.90 
0.16 
9.89 
9.27- 

4.98 660.550 
0.22 247.788 
0.39^8. 1407.132 
0 . 77 Y»a* <3ec/?^ 
1.08 
0.17 
I I. 



6.55 
0.39 
0.86 
1.74 
0.15 
9.02 
8.45 
4.54 
0.20 
0.36 
0.70 
0.98 
0.16 
8.84) 

0.0 0 y*" ^ 

0.03 0.04 f^cUr 
68.59 7t> 



Vol** 
2130.424 
1993.209><w ^ 

348. 9463 1 \ 

9579 . 170 ^-^^ *- *e /act' v*T« ^ se^5) 

17426.208 . 
1713.504 "Vc> f*e* ptfWT HfWlty 



<^ 1 Of 3 
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TRAFFIC CONTROL METERS 



traffic control meters 



m TRAFFIC CONTROL METERS - DISPLAY THE STATE OF THE SCHEDULER 



S OUTPUT COMES IN THREE PARTS, SHOWN OUT OF ORDER HERE; 



QUEUE LENGTHS AND RESPONSE TIME - THESE ARE WEIGHTED AVERAGES 
OVER THE LAST FIFTEEN SECONDS. 



ACTIVITIES VERSUS DEPTH - HOW DEEP THE TRAFFIC CONTROLLER HAD 
TO SEARCH TO FIND A SCHEDULABLE PROCESS 

MISCELLANEOUS COUNTERS AND FREQUENCIES OF VARIOUS EVENTS 



Total metering time 0:20:34 ^ n\^\cX 

Ave queue length 16.52 ~^ v ?> 

Ave eligible ~ 13.31 W*> ^ focS \ V- ^ 



Response time 0.264 sec ^^'^^Vr ^el«v^ 



PTH 


%PF 


TBPF 


%GTW 


TBS 


%CPU 


1 


12.0 


22.8 


10.8 


11.6 


8.1 


2 


11.8 


21.0 


9.2 


12.2 


7.4 


3 


10.8 


24.9 


8.7 


14.1 


8.0 


4 


10.2 


27.9 


8.5 


15.2 


8.4 


5 


9.5 


29.8 


8.3 


15.5 


8.4 


6 


8.4 


33.5 


7.8 


16.5 


8.4 


7 


7.4 


36.3 


7.3 


16.8 


8.0 


8 


30.0 


48.6 


39.5 


16.8 


43.3 
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traffic control meters 



COUNTER 


TOTAL 




ATB 


#/INT 


Interactions 


7977 


0. 


i j j 


cor 

see 




Loadings 


12161 


0. 




sec 


1.525 


Blocks 


14082 


0. 


u o o 


ear* 




Wakeups 


36078 


0. 


n ^ a 


sec 




Schedulings 


12591 


0. 


nQR 


sec 


1.578 


Lost priority 


1 


1234. 


/ 3 O 


sec 




Priority boosts 


0 


0. 


n n n 
u u u 


sec 




I/O boosts 


578 


2. 


1 JO 


sec 




Wait Page 


127040 


9. 


719 


msec 


15.926 


Wait PTL 


75691 


16. 


313 


msec 


9.489 


Wait Other 


31912 


38. 


693 


msec 


4.001 


Total Waits 


234643 


5. 


262 


msec 


29.415 


Notify Page 


128954 


9. 


575 


msec 




Notify PTL 


75691 


16. 


313 


msec 




Notify Other 


25330 


48. 


747 


msec 




Total Notifies 


229975 


5. 


369 


msec 




Get Processor 


245856 


5. 


022 


msec 




Pre-empts 


94235 


13. 


103 


msec 


11.813 


Getwork 


338802 


3. 


644 


msec 




Retry getwork 


4988 


0. 


248 


sec 




Extra notifies 


2949 


0. 


419 


sec 





Last EN event 000000000071 
Last NTO event 033022237767 



ALARM_CLOCK_METERS - DISPLAYS INFORMATION ABOUT THE USER ALARM 
TIMER FACILITY (HARDCORE INTERFACE FOR t imer_manager_) 



Total metering time 0:20:31 



No. alarm clock sims. 2171 
Simulation lag 5.245 msecs. 

Max. lag 1.7340314e4 msecs. 
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traffic control queue 



TRAFF 1 C^CONTROL QUEUE - DISPLAYS THE 
SCHEDULER QUEUES, USEFUL FOR GETTING 
PROCESSES ARE DOING 



-A 0 



,K> I FIRST PART OF 



avq = 13 
v flags 
^4-rWLE (d) 



e 1 apse 



TPUT IS 
tinfle = 121*7 



CURRENT 
AN IDEA 



CONTENTS 
OF WHAT 



OF 
THE 



THE 
USER 



■ — xLED (c) 




dtu 


dpf 


temax 


te 


ts 


ti 


U8 


6946 


2097 


37 


0 


0 


15 


1111 


1000 


910 


2012 


1897 


* *+ 


1370 


500 


89 


0 


0 


- ^ 


823 


500 


13 


0 


0 


1 ■; 


634 


500 


422 


0 


0 


6 


1 Do 


1000 


495 


2054 


2001* 


Ifc 


0 1 . 
CO** 


1000 


85 


0 


510 


4bS 


2734 


1000 


315 


3010 


8000 


17 


656 


500 


60 


0 


0 


12 


520 


50c 


50 


0 


0 


63 


1595 


500 


21 


0 


0 


12 


572 


50c 


55 


0 


0 


67 


3279 


500 


0 


0 


0 



ELIGIBLE QUEUE :-V v «-e 5l £w^* 

sec, 64 a\tive lafet 15 se 
tssc event 






r r 

ws wc process , -v . & 

6 0 .n.t.ilizer-^^j^^ot 
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traffic control aueue 



I SECOND PART IS REALTIME , INTERACTIVE, AND ALL WORKCLASS QUEUES: 



REALTIME QUEUE : 
INTERACTIVE QUEUE: 





9 
t. 


^ULuu » 






•J I D Ills . 


WORKCLASS 


3 


QUEUE : 


credits 




242 ms. 


r 


23S 


5326 


1000 


0 


0 




131 


2513 


1000 


0 


4010 8 


WORKCLASS 


4 


QUEUE : 


credits 




2601 ms. 


WORKCLASS 


5 


QUEUE : 


credits 




4000 ms. 


WORKCLASS 


6 


QUEUE : 


credits 




-563 ms. 


WORKCLASS 


7 


QUEUE : 


credi t s 




3962 ms. 


rw 


5 


166 


500 


0 


0 


WORKCLASS 


S 


QUEUE : 


credi ts 




3934 m s . 


WORKCLASS 


9 


QUEUE : 


credits 




2216 ms. 


WORKCLASS 


10 


QUEUE : 


credits 




4000 ms. 


WORKCLASS 


11 


QUEUE : 


credits 




4 000 ms. 



503 



.0 



^0(Tec( "70 Our 



0.218 
0.128 



0 0 
0 0 



22 3 Dupuis 
0 3 Falkseni 



0.192 



0 0 



7 Saccuci 
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TRAFFIC CONTROL METERS f« ^ * T SKV fr cU^g. 
work class meters 



b WORK_CLASS_METERS - DISPLAY THE VARIOUS WORKCLASS PARAMETERS , AND 
SH0W~WHAT RESOURCES EACH WORKCLASS IS CONSUMING. 



Total meter i ng 1 1 Ti 




WC %GU"AR %MAX %TCP V/ELIG PW IRESP I QUANT RESP QUANT P M R I LCG^^JO 1 °>* 



0 






3. 


0. 12 3 


0.26 2. 10 0».26 


2. 10 


P 


0 


1 






3- 


0.09 1 


0.25 0.75 0.50 


1.00 


P 


0 


2 






15- 


0.1+4 1 






P 


0 


3 


32. 




44. 


0.49 1 






P 


0 


4 


0 

^ • 


14. 


4. 


0.26 1 






P 


0 


5 


20. 




2. 


0.46 1 






P 


0 


6 


12. 


16. 


8. 


0.25 1 






P 


0 


7 


5- 


7. 


4. 


0.36 1 






P 


0 


8 


6- 




0 . 


0. 18 1 






P 


0 


5 


4. 


8. 


2. 


0.62 1 






P 


0 


10 


3- 




0. 


0.55 1 






P 


0 


11 


L . 




2 . 


0. 16 1 






P 


0 


TCPJ 


percents 


(%GUAR) 


control 


non-realtime wo r k_e 


asses 







R I Init 
R I RTime 

I System SysAdm OPR F 
I SysProg SysDev 

SEngr 
I HEngr 

MktUS MktFor MktEd 

DS-CC 
I OffAutc 

Mi sc M* g 
I Other 
I Special 
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RESPONSE JtETERS - DISPLAYS RESPONSE 
INTERACTIONS, ON A PER-WORKCLASS BAS i S 



T ! ME 



BASED ON 



TERM IN A! 




"o la 1 meter i nc t ime 



•-Tn i nks/-- 
•-Queues 



r 



-- — Response TimeV by VCPU Range ■ Load Control Group 



-VCPU Range- 





Avg 


F rorr. 




To 












86 


2. 


,70 


0.00 


0 


•50 


92 


0. 


.15 


0.50 


1. 


.00 








2.00 


10 


.00 


35 


i i . 


■ 75 




o 


• 50 




0 , 


. 2 1 


c.50 




.00 


593 


H. 


• 90 


0.00 


0 


• 50 


612 




• 15 


C.50 


i 


.00 
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TRAFFIC CONTROL METERS 



resoons meters 



1180 


11-65 


0.00 


0.50 


977 


0.05 


1.13 


20.91 


MktUS MktFor 


1211 


0.58 


0.50 


1 .00 


24 


0.64 


k.SS 


7.74 








1 .00 


10 .00 


16 


l .89, 


1 1 .88 


6.29 












1017 


0. 10 


1.39 


14.38 




259 


U.65 


0.00 


0.50 


292 


0.08 


1.53 


20. 17 


DS-CC 


287 


0.98 


0.50 


1.00 


9 


0.71 


9.03 


12.66- 








1 .00 


10.00 


17 


2.04 


14-76 


7.24 








10 .00 


99.99 


l 


12.22 


99 » 99 


9-45 












319 


0.24 


2.31 


1 1 .86 




73 


2.69 


0.00 


0.50 


79 


0.06 


0.31 


5.45 


Of f Auto 


74 


0.05 


C.50 


1 .00 


2 


0.60 


6-40 


10.62 








1 .00 


10.00 


1 


3.20 


6.73 


2. 10 












82 


0.11 


0.54 


4.94 




94 


u .91 


0.00 


0.50 


80 


0.11 


1 .23 


1 1 .07 


Misc Mfg 


96 


0 . 30 


0.50 


1 .00 


1 1 


0.69 


4.74 


6.91 








1 .00 


10.00 


13 


2.99 


12.52 


4 . 30 












104 


0.53 


3.05 


5-74 




7 


99.99 


0.00 


0.50 


10 


0.11 


1.45 


13-82 


Other 


8 


0.21 


1 .00 


10 .00 


1 


3-88 


33. 11 


10.03 












1 1 


0 .45 


4.88 


10.89 




j* 17 


12.71 


0.00 


0.50 


445 


0.03 


0.50 


15.32 


Spec i a 1 


420 


0. 16 


0.5c 


i .00 


5 


0.57 


3-61 


6-29 








1 .00 


10.00 


4 


1.65 


11.40 


6.90 












454 


C.05 


0.63 


1 1 .93 




535k 


11.13 


0.00 


0.50 


6^54 


0.07 


C.77 


1 1 .40 




6192 


0.29 


c.50 


1 .00 


217 


0.68 


4.54 


6-70 








1 .00 


10.00 


173 


2.31 


13.11 


5-68 








10.00 


99.99 


13 


48-77 


99-95 


3.32 












6S57 


0.24 


1.51 


6.39 




86797 


ca 1 1 s to 


meter 


response_t ime 


283 


i nval i 


d transitions 




Overhead 


0* 


.09% ( 


0.052 


ms ./ca 1 1 ) 







o Bs Reproduced 



F80A 



TRAFFIC CONTROL METERS 

post puroe meters pLc^*^ ^ 



b POST PURGE METERS - DISPLAY THE STATE OF POST-PURGE ACTIVITY. 



B CONSIDERABLY MORE DETAILED METERS ARE KEPT BY RING ZERO, BUT NOT 
REPORTED AND NOT PARTICULARLY INTERESTING. 



Total metering time 0:20:29 

Post purge time 1.41 msec. (0.36% of system) 

Ave list size 17.76 entries 

Ave working set 5.59 pages 

Working set factor 0.50 

Working set addend C 

Thrashing percentage 1.34 % 

Ave post in core 10.65 (59.94 %) 
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TRAFFIC CONTROL COMMANDS 



print tuning parameters oASo CTP 



B PRINT_TUNING_PARAMETERS - PRINT VALUES 
PARAMETERS. MOST CONTROL THE SCHEDULER 



FOR SYSTEM CONTROL 



Current system tuning parameters: 



tef irst 

telast 

timax 

pr i or i ty_sched_inc 

min_eligible 

max_eligible 

max_batch_el ig 

working_set_f actor 

working_set_addend 

deadline_mode 

int_q_enabled 

post_purge 

ko^c^n c, fa m u,t«».Ar> /v^.r^ r e_empt sampled ime 
^ y r. Ac/<§p_a t _n o 1 1 f y 

gp_at_ptlnot i f y 
process_init ial_quantum 

*.f of **esj( ^uit_priority 

j gv_integrat lon*^*^',^ 
J r ea 1 1 i mej_i o_pr i o r i t f^'^ffis 
realtime io deadline? 

J USf( S 



realt ime_io__quantum 
hoti f y_t imeout_interval 
not i f y_t imeout_severity 
"write limit 



0. 5 seconds 

1. seconds 
8. seconds 
80. seconds 

2. 

20 . -r l 

0.5 



on ^*\^^ *w«W ^^xS.acW 

On Ae^feAT "Uk^ 

0.04 seconds 

of £)vh s*\*?h 

off3' T;K ' ? '" s7 ™v 

2. seconds t* ^ w ^ 

*t. seconas v^ 0rl<c f^ SJ/ j ^w^w^ 
on opr c/P^v/iT ^tct^j 

0. seconds 
0.005 seconds 
30. seconds 

724 



THESE ARE "INTERNAL", NORMALLY NEVER CHANGED, 
IF THE -all CONTROL ARGUMENT IS GIVEN 



AND ONLY PRINTED 



stack_truncat ion on 

stack_truncation__always off 

stk_trunc_block_avg_f actor 0.25 

trap__invalid_masked off 

meter_ast_locking off 

checksum_f ilemap on 
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TRAFFIC CONTROL COMMANDS 

print apt entry J^^f-^-F 9^4- 



B PRINT APT ENTRY - INTERPRETS AND DUMPS AN APT ENTRY 



! print_apt_entry Sibert -dump 

Sibert.Multics.a b.hl26 at 10300 in tc_data, >pdd> ! BblCpbBbBBBBBB 

PID:010300356001 TRM: 000447007410 407777000460 ^> vK^yt cL<i <3/> s Po 

Running for 0.067825 (since 01:28:53). 

Usage: cpu 8:40.8; vcpu 6:04.6; pf 23622. 

te/s/i/x: 0.411 0.000 0.647 32.000. 

Flags : loaded , eligible , mbzll , dbr_loaded. 

Alarm in 31.244 (at 01:29:24). 



0 005400003000 014225000001 

4 000001443141 000000000000 

10 000000000000 000000000000 

14 003000777777 115641364232 

20 000000000000 001360000002 

24 000000000000 000000000000 

30 000447007410 407777000460 

34 000000111567 457736532472 

40 000000000000 000004325430 

44 035117540004 001775100023 

50 000000000000 000000000000 

54 000000111567 457572506651 

60 000000000000 002557051053 

64 000000000000 000000000000 

70 000000000000 000000000000 

74 000000000000 000000000000 



000000056106 010300356001 

000002356631 000172044000 

005200013740 000000002076 

000000000000 003702747134 

000000111567 457572337662 

011700111567 457761705103 

000000000000 000001720440 

003322000000 000000000000 

000000000000 000000000000 

000000000000 002556711030 

000000000004 000000004441 

000000000000 014274070015 

000001720440 776000000000 

000000000000 000000000000 

000000000000 000000000000 

000000000000 000000000000 
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Fault and Interrupt Handling 
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FAULT AND INTERRUPT HANDLING OVERVIEW 



s FUNCTION 



B RESPONSIBLE FOR HANDLING ALL EXCEPTIONS IN A CPU WHETHER 
INTERNAL TO THE PROCESSOR (REFERRED TO AS FAULTS ) OR EXTERNAL 
(REFERRED TO AS INTERRUPTS) 



ESTABLISHES THE SUPERVISOR ENVIRONMENT AT FAULT AND INTERRUPT 
TIME. SAVES THE MACHINE CONDITIONS AND TRANSFERS TO THE 
APPROPRIATE HANDLER 



MAJOR COMPONENTS: THE FAULT INTERCEPT MODULE (fim), WIRED- FAULT 
INTERCEPT MODULE (wired_fim), I/O INTERRUPT HANDLER 
( io_interrupt ) , sys_troufale , page_f ault 



e MAJOR DATA BASES 



fl INTERRUPT VECTORS - ONE SET PER SYSTEM (WIRED) 

Q INTERRUPT PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED 
INTERRUPT TYPE 



| LOCATED AT ABSOLUTE ADDRESS 0. A HARDWARE RECOGNIZED DATA 
BASE 



0 DESCRIBE WHERE TO SAVE THE CONTEXT , AND WHERE TO TRANSFER TO 
TO PROCESS THE INTERRUPT (ALWAYS i o_interrupt ) 
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FAULT AND INTERRUPT HANDLING OVERVIEW 



FAULT VECTORS - ONE SET PER SYSTEM (WIRED) 



| VECTOR PAIR (2 INSTRUCTIONS) - ONE PAIR PER DEFINED FAULT 
TYPE 



g LOCATED AT ABSOLUTE ADDRESS 100 (OCTAL) IMMEDIATELY ABOVE THE 
INTERRUPT VECTORS. A HARDWARE RECOGNIZED DATA BASE 



| DESCRIBE WHERE TO -SAVE THE CONTEXT , AND WHERE TO TRANSFER TO 
TO PROCESS THE FAULT (fim, wired_fim, page_f ault ) 



PROCESS DATA SEGMENT (PDS) - ONE PER PROCESS (WIRED WHEN 
ELIGIBLE) 

| CONTAINS PROCESS RELEVANT INFO SUCH AS PROCESS ID, USER ID, 
HOME /WORKING/PROCESS DIRECTORIES, AIM CLASSIFICATION, INITIAL 
RING, ETC 



0 CONTAINS ALL INFORMATION ABOUT THE PROCESS NEEDED BY THE 
SUPERVISOR CODE WHEN THE PROCESS IS RUNNING 



| CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH CAN RESULT IN GIVING UP THE PROCESSOR: PAGE FAULTS, 
SEGMENT FAULTS, AND ALL FAULTS NOT HANDLED BY THE SUPERVISOR 



PROCESSOR DATA SEGMENT (PROS) - ONE PER CONFIGURED CPU (WIRED) 



| SERVES AS RING- ZERO STACK FOR PAGE CONTROL AND TRAFFIC 
CONTROL 



I ALSO CONTAINS SAVE AREAS FOR CONTEXT INFORMATION ABOUT FAULTS 
WHICH USUALLY DO NOT MEAN GIVING UP THE PROCESSOR: CONNECT 
FAULTS AND INTERRUPTS. 
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FAULT AND INTERRUPT HANDLING OVERVIEW 



fl FIM_TABLE 



S A TABLE IN THE FIM PROGRAM WHICH DESCRIBES THE ACTION TO BE 
TAKEN FOR VARIOUS TYPES OF FAULTS 
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FAULT AND INTERRUPT DATA BASES 



FAULT AND INTERRUPT VECTORS 



B ALL FAULTS AND INTERRUPTS ARE HANDLED IN A CENTRALIZED FASHION 



1 FOR EACH FAULT OR INTERRUPT, THERE ARE TWO INSTRUCTIONS t 

| AN scu INSTRUCTION, TO STORE THE ABSOLUTELY ESSENTIAL DATA 
NEEDED TO RESTART FROM THE FAULT 



I A tra INSTRUCTION, TO TRANSFER TO TO THE APPROPRIATE FAULT 
HANDLER 



0 ASSOCIATED WITH EACH OF THESE INSTRUCTIONS, THERE IS A POINTER 

fl AN SCU DATA POINTER, POINTING TO ONE OF SIX REGIONS WHERE 
FAULT DATA GOES 



0 A FAULT HANDLER POINTER, INDICATING ONE OF THE PROCEDURES 
USED TO HANDLE FAULTS 



0 THESE INSTRUCTIONS AND POINTERS ARE STORED IN THE fault_vector 



THE DATA STORED " BY scu IS ONLY THE "CONTROL UNIT DATA" - EACH 
HANDLER MUST IMMEDIATELY SAVE THE PROGRAM VISIBLE REGISTERS, THE 
EIS POINTER & LENGTH DATA, AND SO FORTH. THIS DATA IS ALWAYS 
STORED IN THE SAME FORMAT, THE MACHINE CONDITIONS STRUCTURE 
(mc . incl .pll ) 
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FAULT AND INTERRUPT DATA BASES 



FAULT AND INTERRUPT VECTORS 



11111111112222222222333333 
123*S6 7S90123«S«78S0]23«S67890!23*S 



0 0 

1 1 

76 62 

77 63 

80 6* 

81 66 

176 126 

177 127 



200 128 

201 129 

202 IX 

203 131 

374 252 

375 253 

376 254 

377 _255 

400 256 

401 257 

402 258 

403 259 

574 380 

575 381 

576 382 

577 383 



(WORDS) 



SCU INDIRECT FOR INTERRUPT TYPE 0 



TRA INDIRECT FOR INTERRUPT TYPE 0 



F= : : 4-1 


SCU INDIRECT FOR INTERRUPT TYPE 31 / 


TRA INDIRECT FOR INTERRUPT TYfE 31 




SCU INOIREDT FOR FAULT TYPE 0 




* TRA INDIRECT FOR FAULT TYPE 0 

1 — i -i . — 





SCU INDIRECT FOR FAULT TYPE 31 



TRA INDIRECT FOR FAULT TYPE 31 



PTR TO STORE AREA FOR INTERRUPT TYPE 0 



PTR TO INTERCEPTOR FOR INTERRUPT TYPE 0 



I— 



PTR TO STORE AREA FOR INTERRUPT TYPE 31 



PTR TO INTERCEPTOR FOR INTERRUPT TYPE 31 



PTR TO STORE AREA FOR FAULT TYPE 0 



PTR TO INTERCEPTOR FOR FAULT TYPE 0 



PTR TO STORE AREA FOR FAULT TYPE 31 



PTR TO INTERCEPTOR FOR FAULT TYPE 31 



FAULT AND INTERRUPT VECTORS 

A HARDWARE RECOGNIZED DATA BASE LOCATED 
AT ABSOLUTE ADDRESS 0 -577 





(ftult_nctor.incl.pl1! 
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FAULT DATA SAVE AREAS 



s THERE ARE SIX REGIONS WHERE MACHINE CONDITIONS ARE STORED. 



| THEY ARE SELECTED TO MINIMIZE THE NUMBER OF TIMES WHEN FAULT 
DATA MUST BE MOVED. USUALLY, ONCE FAULT DATA HAS BEEN STORED IN 
A PARTICULAR PLACE, IT CAN BE RESTORED DIRECTLY FROM THERE, BUT 
SOMETIMES IT MUST BE MOVED TO ANOTHER PLACE 



0 prds$ inter rupt_data - USED FOR INTERRUPTS, ONLY 



D prds$f im_data - USED FOR FAULTS SUCH AS CONNECT FAULTS, WHICH 
WILL BE HANDLED ENTIRELY USING THE WIRED RING ZERO STACK 
( PRDS ) 



| prds$sys_trouble_data - USED FOR THE FAULT THAT CRASHED THE 
SYSTEM". NO MACHINE CONDITIONS ARE EVER STORED HERE DIRECTLY, 
ONLY MOVED HERE. 



| pds$fim_data - USED FOR FAULTS WHICH WILL BE HANDLED IN RING 
ZERO , USING THE RING ZERO STACK, WHERE PAGE FAULTS MIGHT BE 
TAKEN WHILE THE OTHER FAULT IS BEING HANDLED 



| pds$page_fault_data - USED FOR PAGE FAULTS AND TIMER RUNOUTS 
(WHICH INDICATE THE END OF A QUANTUM) - BOTH ARE EVENTS WHICH 
ALMOST ALWAYS RESULT IN GIVING UP THE PROCESSOR, BUT WHICH 
ARE HANDLED ON THE WIRED RING ZERO STACK (PRDS) 



1 pds$signal_data - USED FOR FAULTS. WHICH WILL BE SIGNALLED OUT 
FOR THE USER RING TO HANDLE, IF AN ERROR OCCURS PROCESSING 
SOME FAULT IN RING ZERO, ITS' FAULT DATA IS MOVED HERE BEFORE 
SIGNALLING 



D THERE ARE ALSO SPECIAL STACK FRAMES CREATED BY THE FIM USED FOR 
FAULT SIGNALLING, AND THE MACHINE CONDITIONS ARE COPIED THERE. 
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FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



s CERTAIN FAULTS DESERVE SPECIAL DISCUSSION, AS THEY ARE USED TO 
IMPLEMENT IMPORTANT SUPERVISOR SERVICES 



| LINKAGE FAULT 

J OCCUR WHEN A POINTER CONTAINING 46 OCTAL IN THE LOW SIX BITS 
OF THE FIRST WORD IS USED 

I USED TO IMPLEMENT DYNAMIC LINKING .(SEE NAME/ADDRESS SPACE 
MANAGEMENT, TOPIC 4) 

II USES pds$f im_data, IS HANDLED BY fim.alm, WHICH INVOKES 
Iink_man.pl!, HANDLED ENTIRELY ON THE stack_0 



0 SEGMENT FAULT 



1 OCCURS WHEN AN NON-ACTIVE SEGMENT IS REFERENCED (SEE SEGMENT 
CONTROL, TOPIC 7) 



S USES pds$f im_data, IS HANDLED BY fim.alm, WHICH INVOKES 
seg_fault.pll, HANDLED ENTIRELY ON THE stackj) 



(J A SEGMENT FAULT MAY OCCUR WHILE ANOTHER IS BEING HANDLED , AND 
IT WILL BE HANDLED RECURSIVELY 



PAGE FAULT 



OCCURS WHEN A PAGE NOT IN MEMORY IS REFERENCED (SEE PAGE 
CONTROL, TOPIC 8) 
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FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



| USES pds$page_£ault_data, IS HANDLED DIRECTLY 
page_£ault .aim, AND IS HANDLED ENTIRELY ON THE PRDS. 

| TIMER RUNOUT W<D 0 \y**> 



OCCURS WHEN THE TIMER REGISTER IS DECREMENTED THROUGH ZERO, 
INDICATING THAT THE RUNNING PROCESS HAS NOW OVERSTAYED ITS 
WELCOME, AND SHOULD LOSE ELIGIBILITY 

| TIMER RUNOUT FAULTS ARE ALSO USED INTERNAL TO TRAFFIC 
CONTROL TO IMPLEMENT "PRE-EMPT" SAMPLING; IN THIS MODE, 
NOW THE DEFAULT, THE TIMER GOES OFF EVERY FEW MILLISECONDS 
AND THE PROCESS CHECKS TO SEE WHETHER A HIGHER PRIORITY 
PROCESS WANTS THE PROCESSOR; THIS DOES NOT MAKE THE 
•RUNNING PROCESS INELIGIBLE, HOWEVER, UNLESS ITS QUANTUM 
HAS ALSO RUN OUT 

D A PROCESS RUNNING IN RING ZERO NEED NEVER GIVE UP 
ELIGIBILITY - WHEN A TIMER RUNOUT HAPPENS, IT REMEMBERS, 
AND SETS THE RING ALARM REGISTER, WHICH WILL CAUSE A RING 
ALARM FAULT LATER ON WHEN IT LEAVES RING ZERO 

"\Vr^ kw, V^? 5 via vo^V^/Mc 

USES Dds$Daqe_fault_data , IS HANDLED DIRECTLY BY pxss.alm, 
AND IS HANDLED ENTIRELY ON THE PRDS. 



B RING ALARM FAULT 



OCCURS WHEN A PROCESS RETURNS TO AN OUTER RING FROM AN INNER 
RING, AND THE RING ALARM REGISTER HAS BEEN SET 



(1) USED TO DEFER ACTION ON TIMER RUNOUTS AND CONNECT FAULTS 
(SEE BELOW) UNTIL A PROCESS LEAVES RING ZERO 



(2) USED TO ENSURE THAT THE SOFTWARE VALIDATION LEVEL (SET 
WITH cu_$level_set) IS NEVER LOWER THAN THE RING OF EXECUTION 
- SETTING THE VALIDATION LEVEL ALSO SETS THE RING ALARM 
REGISTER, AND THE RING ALARM FAULT CAUSES THE VALIDATION 
LEVEL TO BE RESET 
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IMPORTANT TYPES OF FAULTS 



| USES pds$page_f ault_data , IS HANDLED DIRECTLY BY 
ring_alarm.alm AND IS HANDLED ENTIRELY ON THE PRDS. 

| IS ACTUALLY A SUBTYPE OF ACCESS VIOLATION 



1 OCCURS WHEN ONE PROCESSOR SENDS A "connect" TO ANOTHER, USING 
A cioc INSTRUCTION 

| ' RESEMBLES A SOFTWARE SENDABLE INTERRUPT; ALTHOUGH 
PROCESSORS CAN SEND INTERRUPTS TO EACH OTHER, LIMITATIONS 
OF THE HARDWARE MAKE CONNECT FAULTS EASIER TO USE 



| USED FOR ALL INTERPROCESSOR SIGNALLING - 

B (1) TO CAUSE ANOTHER PROCESSOR TO SELECTIVELY CLEAR ITS 
CACHE OR ASSOCIATIVE MEMORY 

D (2) TO PRE-EMPT A PROCESS RUNNING ON ANOTHER CPU (WHEN 
PRE-EMPT SAMPLING IS NOT IN USE) 

fl (3) TO INFORM ANOTHER PROCESSOR THAT THE SYSTEM IS 
CRASHING 

| (4) TO INFORM ANOTHER PROCESSOR THAT IT IS BEING REMOVED 
FROM THE CONFIGURATION 



0 USES prds$f im_data, IS SOMETIMES HANDLED BY wired_f im.alm, 
AND IS HANDLED ENTIRELY ON THE PRDS. 

J FOR TYPE 1 CONNECTS (CACHE CLEAR), THE FAULT IS HANDLED 
VERY SPECIALLY BY CODE WHICH IS ACTUALLY EXECUTED FROM 
WITHIN THE PRDS (SEE f ast_connect_init .aim) , AND RUNS 
SOMEWHAT FASTER. THE COMPLICATED CASES ARE LEFT TO 
WIRED FIM r 



fl CELLS IN THE scs ARE USED TO DISTINGUISH BETWEEN THE 
DIFFERENT TYPES OF CONNECT FAULTS; A PROCESSOR SETS THE 
APPROPRIATE CELLS BEFORE SENDING THE CONNECT. 



3 CONNECT FAULT 
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FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



OTHER FAULTS 



0 PARITY - RUN AUTOMATIC PARITY ERROR LOGGING AND DIAGNOSIS (TO 
CHIP LEVEL, FOR CACHE) ROUTINES 



I OP_NOT_COMPLETE , COMMAND, SHUTDOWN, STARTUP, STORE, TROUBLE - 
RUN HARDWARE ERROR LOGGING ROUTINES 



B OVERFLOW, UNDERFLOW - CAN BE SET UP TO AUTOMATICALLY SET A 
SPECIFIED (VERY LARGE OR VERY SMALL) VALUE AND RESTART 
WITHOUT INTERRUPTING THE RUNNING PROGRAM 



| DERAIL - USED WHEN CRASHING THE SYSTEM OR VOLUNTARILY 
RETURNING TO BOS TO BEGIN EXECUTION IN BOS. AN ORDINARY 
SIGNALLABLE FAULT AT ALL OTHER TIMES (AND USED THAT WAY BY 
THE gtss EMULATOR), on ^ ^oK^ Sck*/v\i*r ho Se»MfU^ 

Q EXECUTE - USED TO FORCE A SYSTEM CRASH 



0 ACCESS VIOLATION - CAN AUTOMATICALLY LOG ACCESS VIOLATIONS 
FOR SECURITY AUDITS 



D OTHERS - HANDLED BY fim.alm, WHICH MAPS THE HARDWARE FAULTS 
ONTO THE MULTICS ENVIRONMENT CONDITION NAMES 

0 CONSIDERABLE INTERPRETATION IS SOMETIMES REQUIRED; FOR 
INSTANCE, A NULL POINTER IS ACTUALLY SIGNALLED BY THE 
HARDWARE AS AN ACCESS VIOLATION, OUT OF BOUNDS ON DSEG, 
FAULT 



I NTERRUPT 



fl INTERRUPTS ARE USED TO ANNOUNCE THE COMPLETION OF ALL I/O 
OPERATIONS, AND ALSO (RARELY) USED DURING DYNAMIC 
RECONFIGURATION TO START PROCESSORS 
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FAULT AND INTERRUPT DATA BASES 



IMPORTANT TYPES OF FAULTS 



| USES prds$interrupt_data, IS HANDLED DIRECTLY BY 
iom_interrupt .aim OR init_processor .aim, AND IS HANDLED 
ENTIRELY ON THE PRDS. 
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FAULT /INTERRUPT METERS 



fim meters 

B FIM METERS - COUNTS FOR ALL FAULT PROCESSING 



Total metering time : 0 s 20 : 28 

fault type count 

shutdown 0 

store 0 

mmel 0 

f ault_tag_l 2 

timer__runout 12907 

command 5 

derail 0 

lockup 0 

connect 742501 

parity 0 

i llegal_procedure 0 

op_not_complete 0 

startup 0 

overflow 0 

divide_check 0 

execute 0 

segment_f ault 6697 

page_fault 151772 

directed_f ault_2 0 

di rected_f ault_3 0 

access_violat ion 21120 

mme 2 ™ 0 

mme3 0 

mme 4 0 

iinkage_fault 21C58 

fault_tag_3 0 

trouble 0 
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interrupt meters 



» I NTERRUPT_METERS - COUNTS & TIMING FOR ALL I/O INTERRUPTS 



Total metering time 0:20:28 



IOM Ch 
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A 


6 
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11 
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A 


10 
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A 


13 
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0.65 


fnp c 


A 


14 


19 
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0.00 


opc 


A 

St, 


16 


26248 


1.347 


0.72 


tapa 


A 


17 


128 


1.328 


0.00 


tapa 


A 


18 


13097 


5.383 


1.43 


fnp b 


A 


2n 

*- u • 


21041 


0.860 


0.37 


dska 




21 


2881 


0.860 


0.05 


dska 


A 


22 


8486 


0.877 


0.15 


dskb 


A 


23 


257 


0.964 


0.01 


dskb 


A 


24 


17896 


0.895 


0.33 


dskb 


A 


25 


2573 


0.943 


0.05 


dskb 


A 


26 


10486 


0.857 


0.18 


dska 


A 

** 


27 


255 


0.899 


0.00 


dska 




2 3 


24717 


0 .845 


0 . 43 


dskc 


A 


29.' 


2319 


0.849 


0.04 


dskc 


A 


30. 


9915 


0.845 


0.17 


dskc 


A 


31. 


215 


0 .767 


0 00 


dskc 


B 


14. 


236 


0.877 


0.00 


fno d 


B 


15. 


6917 


3.351 


0.47 


fnp f 


B 


18. 


3547 


3.543 


0.26 


fnp a 


B 


19. 


13667 


3.435 


0.96 


fnp e 


B 


20. 


22013 


0.881 


0.39 


dskb 


B 


21. 


4745 


0.863 


0.08 


dskb 


B 


22. 


6054 


0.861 


0.11 


dska 


B 


23. 


60 


0.925 


0.00 


dska 


B 


24. 


15946 


0.867 


0.28 


dska 


B 


25. 


989 


0.841 


0.02 


dska 


B 


26. 


12757 


0.863 


0.22 


dskb 


B 


27. 


1020 


0.903 


0.02 


dskb 


B 


28. 


5178 


0.838 


0.09 


dskc 


B 


29. 


30 


0.653 


0.00 


dskc 


B 


30. 


• 16582 


0.823 


0.28 


dskc 


B 


31. 


825 


0.841 


0.01 


dskc 


B 


32. 


1764 


0.825 


0.03 


dske 


Chan 


262506 


1.464 . 


7.82 




Ovhd 


258932 


0.230 


1.21 




Total 


258932 


1.713 


9.03 





special 



Not To Be Reproduced 



10-13 
(End Of Topic) 



F80A 



TOPIC XI 
System Initialization/Shutdown 



Page 

System Initialization Overview 11-1 

System Initialization Terminology 11-4 

Initialization Data Bases 11-7 

Environment Passed to Initialization ... 11-10 

Collection 0 11-11 

Collection 1 11-12 

Collection 2 11-14 

Collection 3 11-16 

Normal Shutdown 11-17 

File System Shutdown 11-18 

Emergency Shutdown 11-20 



11-i F80A 



SYSTEM INITIALIZATION OVERVIEW 



8 FUNCTION 



y PREPARE THE SYSTEM TO OPERATE , STARTING FROM A COMPLETELY EMPTY 
MACHINE 



B READS IN SUPERVISOR PROGRAMS FROM SYSTEM TAPE, SNAPS LINKS 
BETWEEN SUPERVISOR COMPONENTS, VERIFIES AND INITIALIZES HARDWARE 
CONFIGURATION, SETS UP SYSTEM DATABASES, ACCEPTS STORAGE SYSTEM 
DISKS AND PREPARES THEM FOR USE BY THE FILE SYSTEM 



I MOST PROGRAMS IN SYSTEM INITIALIZATION ARE DELETED AFTER 
INITIALIZATION IS COMPLETE. 



| SUPERVISOR PROGRAMS ARE LOADED IN THREE "COLLECTIONS" , EACH OF 
WHICH DEPENDS ON THE MECHANISMS SET UP BY THE PREVIOUS ONE 



B MAJOR DATA BASES 



Q THESE DATA BASES ARE ALL BUILT DURING THE PROCESS OF 
INITIALIZATION (EXCEPT FOR THE CONFIG DECK) AND KEPT AFTER 
INITIALIZATION IS FINISHED 



g SEGMENT LOADING TABLE (>sll>slt) 



g CONTAINS AN ENTRY DESCRIBING THE ATTRIBUTES OF EACH SEGMENT 
IN THE SUPERVISOR 
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SYSTEM INITIALIZATION OVERVIEW 



0 NAME TABLE ( >sll>name_table ) 

| CONTAINS A LIST OF NAMES FOR EACH OF THE SEGMENTS IN THE 
SUPERVI SOR 



| DEFINITIONS SEGMENT ( >sll>def initions_) 

| CONTAINS THE DEFINITIONS SECTIONS FOR ALL THE SEGMENTS IN THE 
SUPERVISOR, WHICH ARE USED IN ORDER TO SNAP LINKS BETWEEN THE 
SUPERVISOR MODULES 



D CONFIG DECK ( >sll>conf ig_deck ) 

B CONTAINS A DESCRIPTION OF THE HARDWARE CONFIGURATION AND 
CERTAIN SOFTWARE PARAMETERS 

| PROVIDED TO SYSTEM INITIALIZATION BY BOS 



B SHUTDOWN — TERMINATES THE ACTIVITIES OF THE SYSTEM IN AN ORDERLY 
FASHION 



| TWO TYPES OF SHUTDOWN: 



NORMAL -- REQUESTED BY THE INITIALIZER, RUNS IN THE USUAL 
SUPERVISOR ENVIRONMENT 



EMERGENCY ~ USED AFTER A CRASH, MUST MAKE THE SUPERVISOR 
ENVIRONMENT OPERABLE BEFORE PROCEEDING 
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SYSTEM INITIALIZATION OVERVIEW 



BOTH TYPES EXIST PRIMARILY TO SHUT DOWN THE FILE SYSTEM — THAT 
IS, TO WRITE ALL DATA IN MEMORY INTO ITS PROPER HOME ON DISK 



0 INCLUDES PAGES OF SEGMENTS, VTOCES , VOLUME AND VTOC MAPS 



0 SHUTDOWN ESSENTIALLY RUNS THE STEPS OF INITIALIZATION BACKWARDS, 
BUT WITH A LOT OF SHORTCUTS 
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SYSTEM INITIALIZATION TERMINOLOGY 



CONFIG DECK: A SET OF CARDS OR CARD IMAGES USED TO INFORM THE 
SOFTWARE ABOUT THE OPERATIONAL READINESS OF THE 
HARDWARE PRESENT, SWITCH SETTINGS AND SPECIFICATIONS OF 
SOME SOFTWARE DATA BASES (SIZE, LOCATION, ETC) 



BOS: THE BOOTLOAD.. OPERATING SYSTEM. A SIMPLE OPERATING 

SYSTEM (A ONE CPU, UNPAGED ENVIRONMENT) OF 8 SEGMENTS 
OCCUPYING THE FIRST -16K OF MAIN MEMORY. BOS RESIDES IN 
THE BOS PARTITION WHEN "MULTICS" IS RUNNING 



MST: THE MULTICS SYSTEM TAPE CONTAINS PRECISELY ENOUGH 

INFORMATION (PROCEDURES AND DATA BASES) TO BRING A BARE 
HARDWARE SYSTEM TO MULTICS COMMAND LEVEL (ACTUALLY, 
ONLY ENOUGH OF COMMAND LEVEL TO PERFORM A RELOAD) 



BOOT: THE OPERATIONAL PROCEDURE OF READING THE SEGMENTS FROM 

THE MST AND EXECUTING THE PROCEDURE/SEGMENTS THEREIN 



WARM /COLD 300T: 

BOOTING THE SYSTEM WITH /WITHOUT A HIERARCHY PRESENT 



HARDCORE PARTITION: 

A RLV PARTITION FOR PAGING HARDCORE SEGMENTS CREATED 
DURING BOOTLOAD 
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SYSTEM INITIALIZATION TERMINOLOGY 



DECIDUOUS SEGMENT: 

A SEGMENT READ IN AS PART OF THE BOOTLOAD TAPE AND 
PLACED INTO THE HIERARCHY. DECIDUOUS SEGMENTS ARE PART 
OF THE INITIALIZER'S HARDCORE ADDRESS SPACE AND RESIDE 
ENTIRELY IN THE HARDCORE PARTITION » THEY ARE PUT INTO 
THE HIERARCHY (>sli) IN ORDER TO BE ACCESSIBLE FROM THE 
USER RINGS 



NON DECIDUOUS HARDCORE SEGMENT: 

A PAGED HARDCORE SEGMENT NOT IN THE HIERARCHY (AND THUS 
HAS NO PATHNAME) 
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ORDINARY SEGMENTS: 

> sss > bound _p!1_ 

> udd >MED> Kaiser > Kaiser. mbx 

> udd > Site Sa > H oman > test_pl 1 
Fpd] > stack_4 



DIRECTORY SEGMENTS: 
>udd >udd>SiteSa 
>sss >udd>MED 



REVERSE-DECIDUOUS: 

( per-process, per-bootioad, ring 0 only) 

[pd] > dseg >sI1 >stack_0.nnn 

[pd] > kst 

[pd] > pds 



NON-SUPERVISOR PROGRAMS: 

> sll > bound_command_loop_ 

> sll > bound_rcp_ 



DECIDUOUS: 

> sll > bound _sss_wired_ 

> sl1 >sys_info 

> sll >hcs_ (all ring 0 gates) 



DISK OVERLAY ABS-SEGS: 

volmap_abs_seg 

syserr_log 



NON-DECIDUOUS PAGED: 
bound_file_system 
bou nd __system_f au Its 
str_seg 



UNPAGED: 

sst_seg tc_data 
pxss 

bound_page_cotnrol 
bound _to_wired 
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INITIALIZATION DATA BASES 



B THE TERM INITIALIZATION REFERS TO THE ACTIONS REQUIRED TO CREATE 
THE MULTICS ENVIRONMENT GIVEN THE EXISTENCE OF A CONFIGURATION 
DECK, AND HARDWARE CONTAINING NO OTHER DATA THAN FIRMWARE AND BOS 



B INITIALIZATION IS ACCOMPLISHED BY AN ORDERLY LOADING AND PROCESSING 
OF THE SEGMENTS RESIDING ON THE MULTICS SYSTEM TAPE (MST) 



B THE SEGMENTS OF THE MST MAY BE DIVIDED INTO THREE CATEGORIES: 



| INITIALIZATION SEGMENTS 



0 PROCEDURES USED ONLY FOR INITIALIZATION AND SUBSEQUENTLY 
DISCARDED 



B SUPERVISOR SEGMENTS 



DATA BASES USED DURING INITIALIZATION THAT ULTIMATELY BECOME 
DATA BASES OF I nit ializer . SysDaemon . z 



Q PROCEDURES AND DATA BASES THAT CONSTITUTE MULTICS HARDCORE 
SUPERVISOR IN ITS ENTIRETY 



| NON- SUPERVISOR SEGMENTS 



D THE SEGMENTS OF COLLECTION THREE ARE PRECISELY THE 

NON-SUPERVISOR SEGMENTS OF THE MST. THESE SEGMENTS ARE 

LOADED DIRECTLY INTO >system_l ibrary_l , AND ARE NOT PART OF 
THE RING ZERO SUPERVISOR 
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INITIALIZATION DATA BASES 



B BOOTLOAD PROCESSOR 



| ONE PROCESSOR (THE BOOTLOAD CPU) PERFORMS ALL OF INITIALIZATION 
RUNNING EXCLUSIVELY IN RING ZERO 



| IN THE MOST OF INITIALIZATION (COLLECTION ONE AND MOST OF 
COLLECTION TWO) , THERE ARE NO PROCESSES, AS SUCH. THE 
ENVIRONMENT WHICH RUNS THERE EVENTUALLY BECOMES THE 
Ini t ializer .SysDaemon PROCESS 



1 NOTE: SINCE THE Initializer . SysDaemon DOES NOT LOGIN LIKE OTHER 
USERS, IT DOES NOT APPEAR IN THE NORMAL USER TABLE, CONSEQUENTLY 
IS NOT VISIBLE TO THE who COMMAND 



B STRATEGY OF INITIALIZATION: BOOTSTRAPPING 



THE FIRST PROCEDURES RUN IN " AN ENVIRONMENT DEVOID OF ALL 
SOFTWARE ASSISTANCE 



EACH NEW MECHANISM (SEGMENTATION, STACKS , SYMBOLIC LINKING, 
PAGING, ETC) IS MADE OPERATIVE AS SOON AS POSSIBLE TO ENRICH THE 
ENVIRONMENT IN WHICH FURTHER MECHANISMS ARE MADE OPERATIVE 



| MANY MECHANISMS HAVE SUBSYSTEMS THAT CONTROL THEM AND THESE 
SUBSYSTEMS ARE NORMALLY INITIALIZED BY CALLING A SPECIAL ENTRY 
POINT IN THE SUBSYSTEM WHICH PERFORM SUCH TASKS AS: 

| CREATING TABLES WHOSE SIZES ARE DETERMINED BY DATA SPECIFIED 
IN THE "CONFIG" DECK 

D THREADING OF RELEVANT LISTS 
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INITIALIZATION DATA BASES 



8 SEGMENTS ON THE MST ARE ARRANGED IN SUCH AN ORDER THAT THE 
EARLIER SEGMENTS ALLOW AS MANY MECHANISMS AS POSSIBLE TO BE USED 
IN LOADING AND PROCESSING OF THE LATER SEGMENTS 



8 FOR THIS PURPOSE (AND BECAUSE THE SIZE OF THE MST IS POTENTIALLY 
LARGER THAN MAIN MEMORY), THE MST IS DIVIDED INTO FOUR PARTS 
KNOWN AS COLLECTION ZERO, ONE, TWO AND THREE 



8 INITIALIZATION CAN BE VIEWED AS THE LOADING AND PROCESSING OF 
COLLECTION ONE, COLLECTION TWO, AND COLLECTION THREE, IN TURN 



8 THE ADDRESS SPACE OF INITIALIZATION (MINUS THE INITIALIZATION 
SEGMENTS) BECOMES THE GLOBAL SUPERVISOR ADDRESS SPACE OF MULTICS 



8 THIS ADDRESS SPACE IS "CLONED" TO BECOME ' THE INITIAL ADDRESS 
• SPACE OF NEWLY CREATED PROCESSES BY DUPLICATING THE DSEG 
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ENVIRONMENT PASSED TO INITIALIZATION 



B THE FIRST SEGMENT OF COLLECTION ONE IS THE BOUND SEGMENT 
bound bootload 1 



SB AT THE TIME CONTROL IS TRANSFERRED TO bound_bootload_l , IT IS 
REQUIRED THAT BOS HAS INITIALIZED MAIN MEMORY AS FOLLOWS: 



| THE IOM MAILBOX MUST BE AT LOCATION 1400 AND CONTAIN THE CHANNEL 
AND DEVICE NUMBER OF THE TAPE DRIVE ON WHICH THE MST IS MOUNTED 



0 THE CONFIG DECK (AS PRODUCED BY BOS) MUST RESIDE AT LOCATION 
14000 THRU 15777 



0 THE BOS TOEHOLD AND FLAGBOX MUST BE AT LOCATION 10000 THRU 11777 



D THIS ONE PAGE CONSTITUTES ALL KNOWLEDGE THAT MULTICS HAS OF 
BOS 



| TRANSFERRING CONTROL TO THE START OF THE BOS TOEHOLD WILL 
CAUSE: 

g FIRST 64K OF MAIN MEMORY TO BE FLUSHED OUT TO THE BOS 
PARTITION 

0 THE 30S OPERATING SYSTEM TO BE READ INTO THE FIRST 64K OF 
MAIN MEMORY 

0 CONTROL GIVEN TO BOS 



D THE REMAINDER OF MAIN MEMORY MUST CONTAIN ZEROES 
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COLLECTION 0 



» THIS CONSISTS OF THE SEGMENTS WHICH ARE DEFINED TO BE PRESENT IN 
THE INITIAL ADDRESS SPACE 



| THESE SEGMENTS ARE EMPTY, AND OVERLAY SPECIFIC REGIONS OF MAIN 
MEMORY. THEY ARE DEFINED SO THAT bound bootload_l CAN KNOW WHAT 
SEGMENT NUMBERS TO USE FOR WHAT DATA 



fl THE COLLECTION ZERO SEGMENTS ARE dseg, f ault_vector , 

ioinjnailbox , conf ig_deck , dn355_mailbox , bos_toehold, flagbox, 
sit, and name__table 

fl SEE SECTION 5, NAME / ADDRESS SPACE MANAGEMENT, FOR THEIR 
DESCRIPTIONS 
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COLLECTION 1 



» COLLECTION 1 CONTAINS ALL OF THE PROCEDURES AND DATA BASES 
NECESSARY TO MAKE PAGING OPERATIVE 

b BASIC STEPS OF COLLECTION 1 LOADING AND INITIALIZATION: 

S bound_bootload_l GAINS CONTROL FROM BOS, IN ABSOLUTE MODE, AND 
PERFORMS THE FOLLOWING: 

I LOADS THE REMAINDER OF ITSELF INTO MAIN MEMORY 

0 ESTABLISHES INTERIM FAULT AND INTERRUPT VECTORS 

| INITIALIZES THE INITIALIZATION DSEG , AND ENTERS APPENDING 
MODE 

g READS THE REMAINDER OF COLLECTION 1 INTO MAIN MEMORY 
(INCLUDING A SEGMENT NAMED bootstrap2) 

D bound_bootload_l TRANSFERS TO bootstrap2 

Jj bootstrap2 PERFORMS THE FOLLOWING: 

| CREATES A STACK FRAME IN THE SEGMENT "inzr_stkO" 

D CALL THE APPROPRIATE PROCEDURES TO PRELINK THE SEGMENTS OF 
COLLECTION 1 

| SETS UP THE PL/I ENVIRONMENT AND CALLS THE FIRST PL/I 
PROCEDURE "initializer" 
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COLLECTION 1 



I initializer (A SUPERVISOR SEGMENT), ACTUALLY CALLS 
real_initializer TO DO THE REAL WORK. ALL THE REST OF 
INITIALIZATION TAKES PLACE VIA CALLS IN real_init ializer 

1 FOR DEBUGGING PURPOSES , THERE IS A MECHANISM IN 
real_initializer WHICH CAN BE USED TO STOP AT ANY OF THOSE 
CALLS BY SETTING A VALUE IN THE PROCESSOR SWITCHES 



THE MAJOR INITIALIZATIONS PERFORMED IN THE REST OF COLLECTION 
ONE ARE: 



I NI TI ALI ZE THE SCU , CLOCK , AND CPU CONTROL MECHANI SMS , 
CHECKING THE SWITCHES AND THE ADDRESSABILITY OF MEMORY 



INITIALIZE FAULT AND INTERRUPT PROCESSING. INITIALIZE THE 
CONSOLE AND SYSERR MECHANISMS 



INITIALIZE PRIMITIVE TRAFFIC CONTROL (WAIT FOR SINGLE 
EVENTS). INITIALIZE THE SST 



INITIALIZE AND CHECK THE DISK CONFIGURATION. AT THIS POINT, 
IT BECOMES POSSIBLE TO TAKE PAGE FAULTS, AND ALL FURTHER DISK 
I/O IS DONE BY PAGING 



CHECK THE ROOT VOLUMES SPECIFIED ON THE ROOT CARD, AND 
INITIALIZE THE HARDCORE PARTITION MECHANISM. THIS ALSO 
INCLUDES CREATING THE PARTITIONS AND VTOC IN A COLD BOOT 



MAKE SEGMENTS PAGED — AT THIS POINT, ALL PAGED SUPERVISOR 
SEGMENTS ARE COPIED INTO THE HARDCORE PARTITION, AND ACCESSED 
BY THE NORMAL PAGE FAULT MECHANISM. COLLECTION ONE ENDS HERE 
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COLLECTION 2 



s COLLECTION TWO - THE REST OF SUPERVISOR INITIALIZATION 



READ IN THE REST OF THE SUPERVISOR SEGMENTS FROM TAPE AND 
INITIALIZE THE REST OF THE SUPERVISOR DATABASES 



WHEN COLLECTION TWO IS FINISHED, THE INITIALIZATION ENVIRONMENT 
HAS BECOME Initializer PROCESS, AND IT CALLS OUT TO RING ONE TO 
START OP THE ANSWERING SERVICE 



| THE FOLLOWING MAJOR STAGES TAKE PLACE IN COLLECTION TWO: 



COLLECTION TWO IS READ FROM TAPE (STILL USING A SPECIAL 
PROCEDURE, tape__reader , WHICH DOUBLE - BUFFERS ) 



THE AND CONDITION SIGNALLING AND HIGHER LEVEL FAULT 
MECHANISMS ARE INITIALIZED 



HIGH LEVEL FILE SYSTEM MECHANISMS ARE INITIALIZED: THE VTOC 
MANAGER, VOLUME DUMPER BIT MAP, SCAVENGER, SEGMENT TRAILERS, 
LOGICAL VOLUME MANAGEMENT; DIRECTORY LOCKING 



TRAFFIC CONTROL IS FURTHER INITIALIZED, AND AN IDLE PROCESS 
IS CREATED FOR THE RUNNING CPU 



SYSERR LOGGING (TO THE SYSERR PARTITION) IS INITIALIZED. ALL 
SYSERR MESSAGES GENERATED AFTER THIS POINT WILL GO IN THE LOG 



THE FILE SYSTEM ON THE RPV IS "ACCEPTED", AND THE ROOT 
DIRECTORY INSPECTED (OR CREATED, IF THIS IS A COLD BOOT) 

0 AFTER THIS POINT, THE CONTENTS OF THE HARDCORE PARTITIONS 
ARE FIXED, AND ALL FURTHER RECORD ALLOCATION AND FREEING 
IS DONE FROM THE PAGING REGIONS OF THE FILE SYSTEM VOLUMES 
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COLLECTION 2 

[J DECIDUOUS SEGMENTS ARE SPLICED INTO THE HIERARCHY 
8 STACK SHARING IS INITIALIZED 



THE REST OF THE SEGMENTS, COMPRISING COLLECTION THREE, ARE 
READ, DIRECTLY INTO THEIR PLACES IN THE HIERARCHY (>sll) 



THE USER VISIBLE SUPERVISOR I/O MECHANISM (ioi) IS 
INITIALIZED, AND THE SPECIAL SUPERVISOR TAPE READER IS SHUT 
DOWN 



TRAFFIC CONTROL IS FULLY INITIALIZED BY CREATING IDLE 
PROCESSES FOR THE OTHER CPUS AND STARTING THEM 



ALL INITIALIZATION SEGMENTS ARE NOW DISCARDED, AND WHAT HAS 
BECOME THE Initializer .SysDaemon PROCESS CALLS init_proc AND 
BEGINS EXECUTION IN RING ONE 
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COLLECTION 3 



» COLLECTION THREE IS NOT PROPERLY A "COLLECTION" AT ALL, BUT JUST A 
TERM USED TO DESCRIBE THE BEGINNING OF Initializer AND ANSWERING 
SERVICE INITIALIZATION 



| MANY THINGS HAPPEN BETWEEN FIRST LEAVING RING ZERO AND LOGGING 
IN THE FIRST USER. MOST HAVE NOTHING TO DO WITH THE FILE 
SYSTEM. THE FEW MOST INTERESTING ONES ARE: 

0 VOLUME ACCEPTANCE - THE NON-ROOT VOLUMES ARE INSPECTED AND 
ACCEPTED INTO THE HIERARCHY. THEIR CONFIGURATION CAN BE 
CHANGED BY USE OF OPERATOR COMMANDS 

| delete_old_Ddds - THE PROCESS DIRECTORY AND DECIDUOUS 
SEGMENTS LEFT OVER FROM THE PREVIOUS BOOTLOAD(S) ARE DELETED 

| THIS MUST BE DONE AFTER THE HIERARCHY I S FULLY AVAILABLE, 
SINCE NON-RLV VOLUMES MAY HAVE BEEN USED FOR PROCESS DIRS 

| VOLUME SCAVENGER AND QUOTA SALVAGER PROCESSES MAY BE STARTED 
AT THIS TIME, IF THERE ARE INCONSISTENCIES IN THE HIERARCHY 
CAUSED BY PREVIOUS CRASHES 
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NORMAL SHUTDOWN 



s WHEN THE SYSTEM IS SHUT DOWN, IT MUST BE DONE IN AN ORDERLY MANNER 



S THIS IS ACCOMPLISHED, MORE OR LESS , BY RUNNING THE STEPS IN 
INITIALIZATION BACKWARDS: 



fl CRAWLOUTS ARE DISABLED. ONCE SHUTDOWN BEGINS, IT CAN'T BE 
STOPPED 



0 THE Initializer SWITCHES TO RUNNING ON THE BOOTLOAD CPU, 
TRAFFIC CONTROL IS DISABLED, AND THE * OTHER CPUS ARE STOPPED 
AND DELETED. 

| LOCKING IS DISABLED AT THIS POINT, SINCE THERE IS NOW ONLY 
ONE PROCESS AND ONE PROCESSOR RUNNING 



ALL THE DISK DRIVES ARE EXERCISED, TO DETERMINE IF ANY ARE 
BROKEN AND CANNOT BE SHUT DOWN 



1 ANY VOLUME SCAVENGES IN PROGRESS ARE STOPPED AND ABANDONED 



0 AT THIS POINT, NORMAL SHUTDOWN IS READY TO SHUT DOWN THE FILE 
SYSTEM, AND ALL THE NORMAL MECHANISMS ARE ASSUMED TO BE 
OPERATING. 



| THE Initializer SWITCHES TO inzr_stkO (WHERE IT ALL STARTED) AND 
CALLS shut down_f iie_sys tern 
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FILE SYSTEM SHUTDOWN 



FILE SYSTEM SHUTDOWN CONSISTS OF FORCING ALL DATA OUT OF MEMORY TO 
ITS HOME ON DISK: 



0 ALL PAGES ARE WRITTEN 



SEGMENTS ARE DEACTIVATED, AND THEIR VTOCES UPDATED 



VOLUMES ARE DEMOUNTED, AND THEIR LABELS UPDATED 



| FILE SYSTEM SHUTDOWN TAKES THE FOLLOWING STEPS: 



ALL MODFIED PAGES ARE WRITTEN TO DISK. THIS IS DONE SEVERAL 
TIMES DURING THE COURSE OF SHUTDOWN 



I STACK_0 SEGMENTS ARE DEACTIVATED AND DISCARDED 

| THE deactivate_f or_demount PROCEDURE IS CALLED TO DEACTIVATE 
ALL OTHER SEGMENTS AND UPDATE THEIR VTOCES 

0 THIS IS DONE BY WALKING THE AST HIERARCHY FROM THE BOTTOM 
UP, DEACTIVATING A SEGMENT, ITS SIBLINGS, AND ITS PARENTS, 
ETC. 

| THIS IS DONE TO ENSURE CONSISTENT QUOTA VALUES IN VTOCES 
AFTER SHUTDOWN, BECAUSE QUOTA MUST BE UPDATED FROM THE 
BOTTOM UP 



ALL VOLUMES ARE DEMOUNTED, THEIR VOUME AND VTOC MAPS UPDATED, 
AND LABELS CHANGED TO INDICATE SUCCESSFUL DEMOUNT 



| THE ORDER IS NOT IMPORTANT, EXCEPT THAT THE RPV GOES LAST 



FILE SYSTEM SHUTDOWN 



1 MEMORY IS FLUSHED AGAIN 



0 IF ANY DRIVES WERE INOPERATIVE, THIS IS ANNOUNCED , AND THE 
RPV IS NOT DEMOUNTED 

0 THIS MAKES IT POSSIBLE TO FIX THE BROKEN DRIVE AND DO AN 
EMERGENCY SHUTDOWN TO FINISH SHUTDOWN 



i IF THERE WERE NO PROBLEMS, THE RPV IS DEMOUNTED AND MEMORY IS 
FLUSHED ONE LAST TIME. ALL RELEVANT INFORMATION IS .NOT ON 
DISK 



| AT THE END OF FILE SYSTEM SHUTDOWN, ALL CONSOLE MESSAGES ARE 
ALLOWED TO COMPLETE, AND THE SYSTEM RETURNS TO BOS 
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EMERGENCY SHUTDOWN 



EMERGENCY SHUTDOWN IS DONE AFTER A CRASH OR SHUTDOWN FAILURE 



LIKE NORMAL SHUTDOWN , THE MISSION OF ESD IS TO SHUT DOWN THE 
FILE SYSTEM, AND IT DOES THIS BY MAKING THE SYSTEM WORK WELL 
ENOUGH TO CALL shutdown_f i le_system 



UNLIKE NORMAL SHUTDOWN, IT CANNOT ASSUME THAT NORMAL MECHANISMS 
ARE OPERATIONAL, AND MUST MAKE THEM WORK FIRST 



AFTER THE SUPERVISOR IS MADE OPERATIONAL, EMERGENCY SHUTDOWN 
TRANSFERS TO THE NORMAL FILE SYSTEM SHUTDOWN 



0 THE FOLLOWING STEPS ARE TAKEN TO REANIMATE THE SUPERVISOR: 
0 . EMERGENCY SHUTDOWN STARTS OUT RUNNING IN ABSOLUTE MODE 



IT ENTERS APPENDING MODE, FINDS THE PRDS FOR THE PROCESSOR IT 
IS RUNNING ON, SETS IT UP AS ITS STACK 



ALL CRITICAL LOCKS (PAGE TABLE, APT) ARE FORCIBLY UNLOCKED. 
TRAFFIC CONTROL IS DISABLED. THE PROCESSOR RUNNING IS NOW 
THE ONLY ONE, AND LOCKS ARE UNNECESSARY 



D . THE CONSOLE AND SYSERR MECHANISMS ARE RESET 



SUPERVISOR I/O SUPPORT, IN PARTICULAR THE DISK DIM , IS 
REINITIALIZED 



D THE STATE OF PAGE TABLES AND THE CORE MAP IS MADE CONSISTENT 

| THIS IS DONE BY pc_recover_sst AND CAN BE DONE ONLY 
BECAUSE ALL OF PAGE CONTROL IS CODED TO FOLLOW PROTOCOLS 
ABOUT THE ORDER IN WHICH TO UPDATE RELATED DATA 
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EMERGENCY SHUTDOWN 



0 BECAUSE OF THIS, IF PAGE CONTROL IS INTERRUPTED AT ANY 
POINT, IT IS POSSIBLE TO DETERMINE WHAT IT WAS DOING AND 
COMPLETE THE OPERATION 

!! THIS STEP IS CRUCIAL TO BEING ABLE TO TAKE PAGE FAULTS 
LATER IN SHUTDOWN 



8 BECAUSE THERE IS NO GUARANTEE THAT THE PROCESS WHICH CRASHED 
THE SYSTEM .(AND THUS, THE ADDRESS SPACE WHERE ESD IS RUNNING) 
IS NOT DEFECTIVE, ESD REBUILDS ITS PDS FROM THE template_pds 



0 ESD SWITCHES TO THE inzr_stkO AND CALLS wired_shutdown 

0 ALL THE ABOVE STEPS WERE DONE IN ALM. w i red_shutdown IS A 
PL/I PROCEDURE 

2 THE VTOC BUFFER IS CHECKED TO SEE WHETHER ANY OPERATIONS WERE 
IN PROGRESS. IF SO, THOSE VOLUMES ARE MARKED (IN THE PVT) TO 
INDICATE THAT THEY MAY HAVE INCONSISTENCIES 

| MEMORY IS FLUSHED 



| THE VTOC MANAGER IS REINITIALIZED 



| AT THIS POINT, THE SUPERVISOR SHOULD BE WORKING WELL ENOUGH 
TO RUN shutdown_f ile_system. FROM NOW ON, EMERGENCY SHUTDOWN 
FOLLOWS THE SAME PATH AS NORMAL SHUTDOWN 



B IF EMERGENCY SHUTDOWN FAILS, FOR TAKING A FAULT OR SOME OTHER 
REASON, IT CAN BE RETRIED INDEFINITELY 



0 SHUTDOWN IS MARKED COMPLETE IN VOLUME LABELS, AND THESE ARE NOT 
UPDATED UNTIL THE t VERY END. THUS, NO HARM CAN COME FROM 
RETRYING ARBITRARILY 

0 ESD TRIES TO CORRECT ALL THE PROBLEMS THAT MIGHT ARISE. 
BECAUSE OF THE COMPLEXITY OF THE SUPERVISOR, IT DOES NOT 
ALWAYS GET ALL OF THEM 
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OVERVIEW OF SALVAGERS 



a FUNCTION 



S ENSURE THE CONSISTENCY OF THE FILE SYSTEM DATABASES AND PERFORM 
PERIODIC PREVENTIVE MAINTENANCE OPERATIONS 



| THERE ARE SEVERAL SALVAGERS, EACH WITH A DIFFERENT FUNCTION 

| BECAUSE OF THE COMPLICATED INTERACTIONS THEY HAVE WITH THE REST 
OF THE FILE SYSTEM, THE SALVAGERS ARE PERHAPS THE MOST 
COMPLICATED SINGLE PROGRAMS IN THE SUPERVISOR 



8 SOME SALVAGING IS DONE AUTOMATICALLY, WHEN THE SYSTEM DETECTS AN 
INCONSISTENCY. OTHER SALVAGE OPERATIONS ARE EXPLICITLY 
REQUESTED, BY PRIVILEGED USERS. 

fl EXCEPT FOR SUPERVISOR BUGS, THE ONLY TIME DAMAGE OCCURS THAT 
REQUIRES SALVAGING TO FIX IS AFTER A CRASH WHERE EMERGENCY 
SHUTDOWN FAILS 



a THE SALVAGERS: 



8 DIRECTORY SALVAGER 

8 CORRECTS INCONSISTENCIES IN DIRECTORY SEGMENTS 3Y REBUILDING 
THEM 

B THIS IS THE ONLY SALVAGER INVOKED AUTOMATICALLY IN USER 

PROCESSES: ANY ATTEMPT TO LEAVE RING ZERO WITH A DIRECTORY 

LOCKED FOR WRITING WILL CAUSE IT TO 3E SALVAGED 
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OVERVIEW OF SALVAGERS 



0 DIRECTORY SALVAGING ALSO RECLAIMS WASTED SPACE IN THE 
DIRECTORY, AND IS RUN PERIODICALLY TO COMPACT DIRECTORIES 



1 QUOTA SALVAGER 

1 CORRECTS INCONSISTENCIES IN THE QUOTA SYSTEM 

H PHYSICAL VOLUME SCAVENGER 



RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION FROM THE 
VTOCES ON A VOLUME, THEREBY RECLAIMING ANY RECORDS OR VTOCES 
WHICH MIGHT HAVE BEEN LOST 



RUNS ENTIRELY ONLINE WHILE THE SYSTEM IS UP FOR USERS (NEW IN 
MR1 0.1) 



THIS TYPE OF DAMAGE IS USUALLY BENIGN, SO RUNNING THE 
SCAVENGER CAN BE DELAYED. 



D PHYSICAL VOLUME SALVAGER 

| RECONSTRUCTS RECORD AND VTOCE STOCK INFORMATION 



RUNS ONLY DURING INITIALIZATION, AND THEREFORE DELAYS CRASH 
RECOVERY 



NOW USED ONLY FOR RARE CASES WHERE THERE IS NOT ENOUGH FREE 
SPACE LEFT FOR THE SCAVENGER TO RUN. IN THESE RARE CASES, IT 
IS INVOKED AUTOMATICALLY BY SYSTEM INITIALIZATION. 



0 SWEEP_PV 
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OVERVIEW OF SALVAGERS 

| DELETES UNUSED VTOC ENTRIES WHICH HAVE NO DIRECTORY ENTRY 
POINTING TO THEM 

S RUNS ENTIRELY IN USER RING, EXCEPT FOR ACTUALLY READING VTOC 
ENTRIES AND DIRECTORY ENTRIES 

D PURELY A HOUSEKEEPING FUNCTION, AND RUN ONLY RARELY. 
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DIRECTORY SALVAGER 



THE DIRECTORY SALVAGER IS USED FOR TWO MAIN PURPOSES: DAMAGE 
CORRECTION AND STORAGE RECLAIMATION 



» DIRECTORY DAMAGE ocio^5 fr% **eJ''- 

| DAMAGE CAN OCCUR IN A DIRECTORY FOR SEVERAL REASONS: 

I DISK I/O ERROR WRITING BAD DATA TO A DIRECTORY SEGMENT 
| SUPERVISOR BUG 



CRASH WITHOUT ESD , WHERE THE DIRECTORY WAS UPDATED, BUT NOT 
FULLY WRITTEN TO DISK 



J ACTUAL' DAMAGE TO DIRECTORIES IS COMPARATIVELY RARE, BUT: 

I IF A FAULT OCCURS FOR ANY REASON* WHILE A USER HAS A" DIRECTORY 
LOCKED, THE SYSTEM ASSUMES THE DIRECTORY COULD BE AT FAULT, 
AND SALVAGES ^r^^r^r 

| THIS SORT OF SALVAGING IS DONE BY THE onl ine_salvager 

PROGRAM, WHICH IS INVOKED DYNAMICALLY BY verify_lcck IF A 

PROCESS ATTEMPTS TO LEAVE RING ZERO ("CRAWL OUT") WITH A 
DIRECTORY LOCKED o<^<- 



ORDINARILY, THERE IS NOTHING WRONG, AND THE SALVAGER JUST 
CHECKS OVER THE DIRECTORY 



IF THE DIRECTORY IS DAMAGED, IT IS "REPAIRED" AS WELL AS 
POSSIBLE 
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DIRECTORY SALVAGER 



D UNFORTUNATELY, THE MOST COMMON FORMS OF DAMAGE DESTROY THE 
DIRECTORY HEADER SO THAT NO REPAIR IS POSSIBLE, AND THE 
DIRECTORY MUST BE REINITIALIZED AS EMPTY 

bo\ *<>«({y Tfi;4_y City far f^C^ ^fl r5- 



a STORAGE RECLAIMATION 



B DIRECTORY SPACE CANNOT ALWAYS BE EFFICIENTLY RE-USED, AND 
UNUSABLE SPACE ACCUMULATES AS ENTRIES ARE CREATED AND DELETED 



1 IT IS NOT PRACTICAL FOR THE SYSTEM TO COMPACT DIRECTORIES 
WHEN THIS HAPPENS, SINCE THIS COULD CAUSE MAJOR RESOURCE 
CONSUMPTION, AND CAUSE EXPENSE FOR RANDOM PROCESSES 

1 INSTEAD, THE DIRECTORY SALVAGER IS PERIODICALLY RUN IN 
Salvager .SvsDaemon PROCESSES TO REBUILD ALL THE DIRECTORIES 
IN THE HIERARCHY, COLLECTING ALL FREE SPACE 

| THIS IS DONE BY CALLS TO hphcs_$salv_di rectory 

| IF THE Salvager PROCESSES DETECT DAMAGE, IT IS CORRECTED AS 
WELL 



| DEMAND DIRECTORY SALVAGING IS USUALLY ALSO INSTRUCTED TO LOOK 
FOR AND CORRECT "CONNECTION FAILURES" 

| A CONNECTION FAILURE IS A DIRECTORY 3 RANCH WHICH INDICATES 
A FREE VTOCE, OR A VTOCE WITH A DIFFERENT UID THAN THE 
BRANCH. THIS MEANS THAT THE DIRECTORY AND VTOC ARE 
INCONSISTENT 



0 CONNECTION FAILURES ARE USUALLY DELETED BY DEMAND 
SALVAGING (THIS IS AN OPTION) 

0 ONLINE SALVAGING DOES NOT DELETE CONNECTION FAILURES 
BECAUSE IT IS NOT ALWAYS POSSIBLE TO IDENTIFY THEM 
PROPERLY DURING AN ONLINE SALVAGE 
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DIRECTORY SALVAGER 



| DEMAND DIRECTORY SALVAGING CAN ALSO BE USED BY SYSTEM 
MAINTENANCE PERSONNEL WHEN THERE APPEAR TO BE DIRECTORY PROBLEMS 



Not 
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QUOTA SALVAGING 

/ • 



a QUOTA SALVAGING CORRECTS INCONSISTENCIES IN THE HIERARCHY OF 
QUOTA-USED VALUES 



0 THESE INCONSISTENCIES ARISE AFTER A CRASH WHERE ESD FAILS: 

0 A SEGMENT (>udd>a>b) IS DELETED, FREEING PAGES , AND THE ASTES 
OF ITS PARENT (>udd>a) AND ITS PARENT'S PARENT (>udd) ARE 
UPDATED TO REFLECT 'THIS DECREASE IN QUOTA USED 

8 THE VTOCE FOR >udd>a IS WRITTEN TO DISK DURING NORMAL 
OPERATION. THE VTOCE FOR >udd IS NOT 

0 THE SYSTEM CRASHES, AND NO ESD IS PERFORMED 

| WHEN THE SYSTEM COMES BACK UP, THE VTOCE FOR >udd IS 
INACCURATE: IT CLAIMS THAT RECORDS ARE STILL IN USE, WHEN IN 
FACT THEY WERE FREED 



fl IF A NEW SEGMENT (>udd>a>c) IS NOW CREATED, IT MAY SPURIOUSLY 
CAUSE A RECORD QUOTA OVERFLOW ON >udd. 



| QUOTA SALVAGING IS PERFORMED ENTIRELY ONLINE, WHILE THE SYSTEM 
IS RUNNING, USUALLY IN A Salvager . SysDaemon PROCESS 



| THE FUNDAMENTAL PRINCIPLE BEHIND THE QUOTA SALVAGER IS THAT 
QUOTA INCONSISTENCIES CANNOT ARISE DURING NORMAL OPERATION: 
IF QUOTA IS CONSISTENT, OR INCONSISTENT BY n RECORDS, IT WILL 
STAY THAT WAY UNLESS EXPLICITLY CORRECTED 



B THE QUOTA SALVAGER PROCESS WALKS THE HIERARCHY FROM THE 

BOTTOM UP, USING do_subtree, CORRECTING INCONSISTENCIES IN A 

DIRECTORY AND ALL ITS SIBLINGS, THEN IN THEIR PARENT, AND SO 
ON UP 
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QUOTA SALVAGING 



AN hphcs_ ENTRY IS CALLED TO CORRECT EACH DIRECTORY, ON THE 
ASSUMPTION THAT ALL ITS CHILDREN ARE CONSISTENT 

1 THE ACTUAL CORRECTION MECHANISM INVOLVES COMPLICATED 
MANIPULATION OF VARIOUS LOCKS. REFER TO THE Multics 
Storage System PLM (AN61) FOR A DESCRIPTION 
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PHYSICAL VOLUME SCAVENGER 



8 THIS IS ALSO PRIMARILY USEFUL AFTER A CRASH WITHOUT ESD 



i 

jj IT REBUILDS THE VOLUME MAP AND VTOC MAP FOR A VOLUME BY 
EXAMINING ALL THE VTOCES AND ASTES FOR SEGMENTS ON THE VOLUME 



I IT RUNS WHILE THE VOLUME IS IN USE BY USERS, AND NO INTERRUPTION 
OF SERVICE OCCURS 



1 DAMAGE TO THE MAPS OCCURS AFTER A CRASH WHEN THE STOCKS, IN 
MEMORY, DO NOT GET PROPERLY UPDATED TO THE MAPS ON DISK 



| BECAUSE OF THE STOCK MANAGEMENT POLICIES, THIS IS ALWAYS 
BENIGN: RECORDS MAY BE MARKED IN -USE THAT ARE NOT, BUT IT IS 
NOT POSSIBLE FOR THE MAP TO INDICATE A RECORD AS FREE 
(REUSABLE) WHEN IT BELONGS TO A SEGMENT ON THE VOLUME 



8 FOR RECONSTRUCTING THE VOLUME MAP, THE SCAVENGER WORKS BY AN 
INTERACTION WITH THE PAGE CONTROL RECORD ALLOCATION MECHANISM 



jj IT BUILDS A MAP, IN scavenger_data , THAT SAYS WHAT VTOCE OWNS 
EACH RECORD ON THE VOLUME, AND THEN RESOLVES THE 
INCONSISTENCIES BETWEEN THAT AND THE MAP ON DISK 

| THE DATABASE IS WIRED FOR THE DURATION OF THE SCAVENGE , 
AND CAN BE QUITE LARGE (64K FOR AN MSU0501) 

fl WHILE A SCAVENGER IS RUNNING, PAGE CONTROL KEEPS THE 
DATABASE UP TO DATE AS IT ALLOCATES AND FREES RECORDS 



1 FOR VTOCES, THE PROBLEM IS MUCH SIMPLER: THE VTOC IS SIMPLY 
SCANNED, AND ALL IN-USE VTOCES ARE RECORDED 
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PHYSICAL VOLUME SCAVENGER 



0 vtoc_man ALSO KEEPS THE TABLE UP TO DATE AS IT FREES AND 
ALLOCATES VTOCES ON THE VOLUME 



0 A VTOCE THAT APPEARS IN-USE MAY NOT NECESSARILY BE PART OF 
THE HIERARCHY — sweep_pv IS RUN TO TAKE CARE OF THAT 



AFTER THE NEW MAPS ARE CONSTRUCTED, THEY ARE WRITTEN TO DISK 



| THE SCAVENGE RUNS ENTIRELY IN RING ZERO , BUT IT CAN BE SAFELY 
INTERRUPTED AND RESTARTED FROM THE BEGINNING AT ANY TIME 

I THE SCAVENGER ACCESSES THE VTOC USING vtoc_man 



THE SCAVENGER TAKES ABOUT FIFTEEN MINUTES PER VOLUME, BUT THE 
SYSTEM IS UP WHILE IT DOES SO 




X 
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PHYSICAL VOLUME SALVAGER 



THIS DOES THE SAME JOB AS THE SCAVENGER , BUT CAN RUN ONLY WHEN THE 
VOLUME IS UNAVAILABLE TO USERS 



0 BECAUSE IT HAS THE VOLUME ALL TO ITSELF, IT IS MUCH SIMPLER; 

0 IT SCANS THE VTOC, BUILDING THE SAME SORT OF DATABASES AS THE 
SCAVENGER 



8 WHEN FINISHED, IT RESOLVES INCONSISTENCIES, AND WRITES THE 
MAPS BACK TO DISK 

0 THE VOLUME SALVAGER ACCESSES THE VTOC USING 
salv_abs_seg_NN 



THE VOLUME SALVAGER TAKES ABOUT A MINUTE AND A HALF PER VOLUME, 
BUT ALL VOLUMES MUST BE SALVAGED BEFORE THE SYSTEM CAN RUN AGAIN 



fl AFTER A CRASH WITHOUT ESD, ALL VOLUMES- MOUNTED AT THE TIME "OF 
THE CRASH ARE PRESUMED TO BE INCONSISTENT 



1 THE VOLUME SALVAGER IS LARGELY OBSOLETE TODAY. IT IS RETAINED 
TO DEAL WITH RARE SITUATIONS WHICH MAKE IT IMPOSSIBLE TO BRING 
THE SYSTEM UP FAR ENOUGH TO RUN THE SCAVENGER WITHOUT FIRST 
REBUILDING THE FILE MAP TO FREE UNUSED SPACE 
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SWEEP PV 



sweep_pv ELIMINATES ORPHAN VTOCES 



| AN ORPHAN VTOCE IS ONE WHICH APPEARS TO DESCRIBE A VALID 
SEGMENT , BUT DOES NOT APPEAR IN ANY DIRECTORIES 



| ORPHANS ARE USUAL.LY CREATED BY CRASHES OR DIRECTORY DAMAGE 
WHERE THE DIRECTORY COULD NOT BE REPAIRED 



I ORPHANS ARE ALSO SOMETIMES CALLED "REVERSE CONNECTION 
FAILURES" 



| SweeD_pv WORKS BY INSPECTING EVERY VTOCE ON A VOLUME, AND 
ATTEMPTING TO FIND ITS PARENT 



I THERE IS A "UID PATHNAME" IN PART 3 OF ALL VTOCES WHICH 
CONTAINS THE UIDS OF ALL ITS PARENT DIRECTORIES 



| BY STARTING FROM THE ROOT, AND SEARCHING EACH DIRECTORY IN 
THE PATH FOR THE UID OF THE NEXT ONE, THE VTOCE CAN BE FOUND 

D IF IT CAN'T BE FOUND, IT IS AN ORPHAN, AND SWEEP_PV 



D IT IS POSSIBLE TO "ADOPT" ORPHANS INTO A DIFFERENT PLACE IN THE 
HIERARCHY IF IT IS IMPORTANT TO RECOVER THEIR CONTENTS, USING 
THE adopt_seg TOOL 



| THE UID PATHNAME OF A VTOCE CAN BE INTERPRETED MANUALLY BY USING 
THE vtoc_pathname TOOL 



DELETES IT 
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The Initializer .SysDaemon Process 
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INITIALIZER OVERVIEW 



B FUNCTION 

0 THE SYSTEM'S INITIALIZATION, ADMINISTRATIVE AND CONTROL PROCESS 
(Initializer. SysDaemon.z) , RESPONSIBLE FOR: 

g INITIALIZING THE OPERATING SYSTEM AT BOOTLOAD, FOLLOWING 
SUCCESSFUL INITIALIZATION OF THE SUPERVISOR 

| ANSWERING SERVICE (login and logout) 

| PROCESS CREATION AND DESTRUCTION 

0 MESSAGE COORDINATOR (DAEMON COORDINATION) 
D SYSTEM ADMINISTRATION FUNCTIONS 

1 SYSTEM ACCOUNTING FUNCTIONS 

B MAJOR DATA BASES, ALL KEPT IN >scl 
g AN S WER_T ABLE 

1 ABSENTEE_USER_TA'BLE 
fl DAEMON_USERJTABLE 
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INITIALIZER OVERVIEW 



I! MASTER GROUP TABLE (MGT) 



| CHANNEL DEFINITION TABLE (CDT) 



0 SYSTEM ADMINISTRATION TABLE (SAT) 

Q PERSON NAME TABLE (PNT) 

| PROJECT DEFINITION TABLES (PDT'S) 
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SERVICES OF INITIALIZER 



b THE Initializer .SysDaemon PROCESS PERFORMS VARIOUS SERVICES 
NECESSARY FOR THE SUPERVISOR. MANY OF THEM ARE PERFORMED BY THE 
INITIALIZER PRIMARILY FOR CONVENIENCE, SINCE IT IS EASIER TO 
CONTROL RESOURCES IN A CONTROLLED ENVIRONMENT SUCH AS A SINGLE 
PROCESS THAN TO CREATE A MECHANISM WHICH CAN BE RUN IN ALL 
PROCESSES 



0 SYSTEM INITIALIZATION AND SHUTDOWN 



THE Initializer PROCESS IS CREATED FROM THE ENVIRONMENT THAT 
INITIALIZES THE SUPERVISOR 



Q WHEN THE SYSTEM IS SHUT DOWN, THE Initializer COORDINATES THE 
ORDERLY CESSATION OF SYSTEM ACTIVITY AND CALLS 
hphcs_$ shutdown TO SHUT DOWN THE SUPERVISOR 



8 LOGICAL VOLUME MANAGEMENT 

(j THE Initializer PROCESS HANDLES ALL REQUESTS FROM USER 
PROCESSES TO MOUNT AND UNMOUNT PRIVATE LOGICAL VOLUMES 



IT ALSO MAKES THE NECESSARY CHECKS TO ACCEPT A VOLUME INTO 
THE HIERARCHY OR REMOVE IT FOR DEMOUNTING 



| RESOURCE CONTROL 



I THE Initializer DOES ALL THE CONTROL , ASSIGNMENT, AND ACCESS 
CHECKING OF RESOURCES (SUCH AS I/O DEVICES) CONTROLLED BY RCP 



1 PROCESS CREATION AND DESTRUCTION 
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SERVICES OF INITIALIZER 



D THE Initializer CREATES AND DESTROYS ALL PROCESSES, SCHEDULES 
ABSENTEE PROCESSES, AND HANDLES "CONSOLE" I/O FROM DAEMON 
PROCESSES 

fl AN IMPORTANT SERVICE OF PROCESS MANAGEMENT IS PROCESS DIR 
VOLUME MANAGEMENT, IN WHICH THE Initializer PICKS THE LOGICAL 
VOLUMES USED FOR PROCESS DIRECTORIES 

| THE Initializer ALSO HANDLES ALL PROCESS ACCOUNTING AND LOAD 
CONTROL 



1 COMMUNICATIONS 

D THE Initializer MANAGES LOADING / DUMPING OF FNPs AND 
SOFTWARE COMMUNICATIONS MULTIPLEXERS 

I IT ALSO HANDLES ALLOCATION OF COMMUNICATION CHANNELS, BOTH 
FOR PROCESSES LOGGING IN AND REQUESTS MADE THROUGH 
dial_manager_ 

3 DYNAMIC RECONFIGURATION 

0 THE Initializer RUNS THE DYNAMIC RECONFIGURATION SOFTWARE, 
AND UPDATES THE SYSTEM LOAD LIMITS WHEN THE CONFIGURATION 
CHANGES 

fl ACTUALLY, ANY PROCESS WITH hphcs_ ACCESS CAN USE THE 
RECONFIGURATION COMMANDS, BUT ONLY THE Initializer CAN KEEP 
ALL THE ACCOUNTING DATABASES UP TO DATE 
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METER AND TUNING OVERVIEW 



8 WHILE NOT A SUBSYSTEM ITSELF, METERING AND TUNING IS A POLICY AND 
CAPABILITY COMMON TO ALL OF THE SUPERVISOR'S SUBSYSTEMS 



8 FUNCTION 



| METERING (CONSISTS OF THREE ACTIVITIES) 



fl ACCUMULATING DATA: THIS IS PERFORMED THROUGHOUT THE 
SUPERVISOR BY CODE WHICH 

fl RECORDS THE NUMBER OF TIMES AN EVENT HAPPENS OR A 

PARTICULAR PIECE OF CODE IS EXECUTED; AND/OR 

| RECORDS THE TIME REQUIRED TO PERFORM A TASK 

1 SUCH DATA IS STORED IN AREAS REFERRED TO AS "METERING 
CELLS" 



3 EXTRACTING DATA: THIS IS PERFORMED BY NUMEROUS METERING 
COMMANDS WHICH (WHEN INVOKED) 

8 READ AND STORE THE CURRENT VALUES OF RELEVANT METERING 
CELLS 



| REPORTING THE DATA;- THIS IS PERFORMED BY THE METER COMMANDS 
WHICH (WHEN INVOKED) 

S COMPARE CURRENT METERING CELL VALUES WITH PREVIOUSLY READ 
VALUES 

| PERFORM THE APPROPRIATE ARITHMETIC COMPUTATIONS UPON THE 
DATA IN ORDER TO ARRIVE AT THE DESIRED STATISTIC 

J ARRANGE THE DATA IN A USEFUL FORMAT (A REPORT OR DIAGRAM) 
AND PRINT IT 
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METER AND TUNING QVERVI EW 



Q TUNING 



| CHANGING THE SYSTEM'S OPERATING PARAMETERS AND /OR 
CONFIGURATION BASED UPON THE DATA AND INSIGHTS FROM THE 
SYSTEM'S METERS 



» MAJOR DATA BASES 



H SST HEADER, TC_DATA HEADER, ETC. 
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ANALYZING PERFORMANCE PROBLEMS 



S MULTICS IS VERY HEAVILY INSTRUMENTED WITH MANY METERING COMMANDS 



0 MOST SOLVABLE PERFORMANCE PROBLEMS SHOW UP QUITE DIRECTLY IN THE 
METERS 



J IF THE SYSTEM IS TOO SLOW, THERE ARE GOOD RULES OF THUMB TO 
FOLLOW TO LOOK FOR WHEN PROBLEM 



fl NO TWO SYSTEMS ARE 
YOU HAVE IS HOW THE 
WHEN THE SYSTEM WAS 



IDENTICAL - THE MOST 
METERS ARE DIFFERENT 
WORKING BETTER 



IMPORTANT INFORMATION 
FROM THE WAY THEY WERE 



NOT ALL TUNING PROBLEMS CAN BE RESOLVED WITH SOFTWARE. OFTEN IT 
SIMPLY INDICATES THAT THERE IS NOT ENOUGH MEMORY, OR NOT ENOUGH 
DISK CAPACITY. IT IS OFTEN -DIFFICULT TO DETERMINE WHAT HARDWARE 
CHANGES WOULD BE MOST COST-EFFECTIVE 



s total time meters - THE FIRST STEP 



total_time_meters MAY INDICATE EXCESSIVE TIME SPENT IN SEVERAL 
AREAS : 



1 PAGE FAULTS - TOO MANY PAGE FAULTS MEAN NOT ENOUGH MEMORY, 
TOO MANY ELIGIBLE PROCESSES (max_el igible ) , WHICH CAUSE 
THRASHING, INSUFFICIENT DISK CAPACITY, OR INEFFICIENT 
APPLICATIONS 

0 LOOK TO f ile_system_meters , device_meters , AND di skjneters 
FOR MORE HELP 
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ANALYZING PERFORMANCE PROBLEMS 



| SEGMENT FAULTS - TOO MANY ALMOST ALWAYS MEAN THAT THE AST 
POOLS (sst CONFIG CARD) ARE TOO SMALL 

1 LOOK TO f ile_system_meters (AST Pool grace time) FOR MORE 
HELP 



0 INTERRUPT - USUALLY MEANS EXCESSIVE INTERRUPT ACTIVITY EITHER 
FOR FNPS OR BECAUSE OF EXCESSIVE PAGING , BUT MAY INDICATE 
HARDWARE PROBLEMS 

| LOOK TO interrupt_meters TO ' LOCALIZE IT, THEN TO 
f ile_system_meters and system_comm_meters 

J OTHER FAULT - GENERALLY INDICATES TOO MANY CONNECT OR TIMER 
RUNOUTS FAULTS, INDICATING EXCESSIVE TRAFFIC CONTROL ACTIVITY 

I LOOK TO THE TUNING PARAMETERS (ptp) AND 

traf f ic_control_meters FOR MORE HELP 

1 MP IDLE - INDICATES TOO MUCH TRAFFIC CONTROL ACTIVITY, 
USUALLY BECAUSE THERE ARE TOO MANY ELIGIBLE PROCESSES 
(max_eligible) AND /OR NOT ENOUGH MEMORY 

D LOOK TO THE TUNING PARAMETERS (ptp), f i le_sy s tem_me te r s , 
device_meters , disk_meters , AND traf f ic_control_meters FOR 
MORE HELP 

Jj WORK CLASS IDLE - THIS IS CPU TIME WASTED BECAUSE GOVERNED 
WORKCLASSES WERE NOT PERMITTED TO USE IT, AND NO OTHER TAKERS 
WANTED IT 

I FREQUENTLY NOT A PROBLEM, BUT MAY INDICATE A NEED TO 
READJUST WORKCLASSES ( wor k_c lass_meter s ) 



I NMP IDLE, ZERO IDLE - INDICATE THAT CPU TIME HAS GONE TO 
WASTE BECAUSE NO PROCESSES WANTED IT. NMP IDLE MEANS THAT 
THERE ARE MORE PROCESSORS THAN PROCESSES THAT WANT CPU TIME, 
AND ZERO IDLE MEANS THERE ARE NO PROCESSES AT ALL 
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ANALYZING PERFORMANCE PROBLEMS 



fl NORMALLY INSIGNIFICANT QUANTITIES - THE FOLLOWING NUMBERS 
SHOULD ALWAYS BE VERY SMALL; LARGE VALUES PROBABLY INDICATE A 
HARDWARE OR SOFTWARE PROBLEM 

PC LOOP LOCKS 
BOUND FAULTS 
TC LOOP LOCKS 
POST PURGING 
LOADING IDLE 
OTHER OVERHEAD 
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DETAILED PROBLEM ANALYSIS 



B THE MORE DETAILED METERING COMMANDS CAN BE USED TO PIN DOWN A 
PROBLEM 



DETAILED DESCRIPTIONS CAN BE FOUND IN THE Multics Metering 
Manual (AN52) 



THE DETAILED METERS SHOULD ALSO BE CHECKED IF THERE IS NO 
OBVIOUS PROBLEM SHOWN BY total time meters 



D AGAIN , THE REALLY IMPORTANT THING IS TO BE ABLE TO COMPARE 
AGAINST PREVIOUS DATA FOR YOUR SITE 



B SOME GOOD PLACES TO LOOK ARE: 



0 inter rupt_meters 



D UNUSUALLY LONG DISK INTERRUPTS MAY INDICATE LOCKING PROBLEMS 
- SEE disk meters 



0 TOO MUCH TOTAL TIME SPENT WITH DISK INTERRUPTS USUALLY MEANS 
TOO MANY PAGE FAULTS, WHICH WILL BE SHOWN IN MORE DETAIL BY 
f i le_system_meters 



| FNP INTERRUPTS ARE TYPICALLY MUCH LONGER THAN OTHERS. TOO 
MUCH FNP INTERRUPT TIME MAY INDICATE A BAD FRONT END CHANNEL, 
BUT THIS IS RARE 
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DETAILED PROBLEM ANALYSIS 



jj f i le_system_meters 

Q A SHORT PAGE LAP TIME MEANS THAT PAGES ARE NOT STAYING IN 
MEMORY LONG ENOUGH; THAT IS, THERE IS NOT ENOUGH MEMORY 

Q FREQUENT PAGE CLAIM RUNS INDICATE THAT THE WRITE LIMIT IS TOO 
LOW 



IF THE AVERAGE PAGE FAULT DURATION IS HIGH, IT CAN MEAN THAT 
THE WRITE LIMIT IS TOO HIGH, AND THAT DISK ALLOCATION LOCKS 
ARE A LIMITATION? SEE disk meters TO CHECK 



SHORT AST POOL GRACE TIMES MEANS THAT THE POOL SIZES SHOULD 
BE INCREASED. THIS IS USUALLY ALSO INDICATED BY TOO HIGH A 
FREQUENCY OF SEGMENT FAULTS 



8 disk_meters 

0 WHEN THE ATB I/O FOR A DRIVE IS 'TOO LOW, THE DRIVE IS A 
SERIOUS BOTTLENECK. 

B THIS OFTEN HAPPENS FOR RLV DRIVES, BECAUSE OF DIRECTORIES 
8 IF PARM DIRW IS ON, IT SHOULD BE TURNED OFF 

8 TOO HIGH A PERCENTAGE OF ALLOCATION LOCKS INDICATE THAT TOO 
MANY WRITES ARE BEING QUEUED SIMULTANEOUSLY, AND MAKING IT 
IMPOSSIBLE TO GET A QUEUE ENTRY FOR READING 

8 THIS USUALLY MEANS THAT WRITE_LIMIT IS TOO HIGH 



8 device_meters 

8 IF THE SUBSYSTEM BUSY PERCENTAGE IS TOO CLOSE TO THE DISK 
CHANNEL CAPACITY, IT USUALLY MEANS THAT THERE ARE TOO FEW 
PHYSICAL DISK CHANNELS 
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OUTPUT FROM METERING COMMANDS 



total time meters 



E TOTAL_T I ME — METERS - OVERVIEW OF HOW THE SYSTEM IS USING ITS 
RESOURCES, ALSO MEASURED AGAINST NON-IDLE TIME 



Total metering time 



Page Faults 

PC Loop Locks • 
PC Queue 
Seg Faults 
Bound Faults 
Interrupts 
Other Fault 

Getwor k 

TC Loop Locks 

Post Purging 
MP Idle 

Work Class Idle 
Loading Idle 
NMP Idle 
Zero Idle 
Other Overhead 
Virtual CPU Time 62.53 

fro its 




f 



AVE 
\2130. 


424A' 0PS 


15$3. 


209 


348. 


946 


9579. 


170 


17426. 


208 


1713. 


504 C 


660. 


550 


247. 


788 


1407. 


132 



$oTII? k<?KT. ~TK*s C^cfc Ji5«c-^^^> 



-^ju./t or Tturr 



•9 
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OUTPUT FROM METERING COMMANDS 



interrupt meters 



fi INTERRUPT_METERS - COUNTS & TIMING FOR ALL I/O INTERRUPTS 



Total metering time 0:20:28 



IOM Ch 


I nt 


** V \J X mm ill W 


9: CPU 
"o u* w 




A 


6. 


11 


2 043 


0 00 


IOM A 


A 


10. 


379 


1 553 


0 01 


nrtb 


A 


13. 


9253 


3 436 


0 65 


f nr> r* 


A 


14. 


19 


0 788 

W « /WW 


0 00 


U£JW 


A 


16. 


26248 


1 347 


0 72 


t" a, na 


A 


17. 


128 


1 328 


0 00 




A 


18. 


13097 


5 383 


1 43 




A 


20. 


2 1 041 


D 860 


0 37 


c ir a 

US A.G 


A 


21. 


2881 

•t. w w «i 


0 860 


0 0 R 


h c ir a 

U S ft u 


A 


22. 


8486 

U T u u 


0 877 


0 15 




A 


23 . 


2 C 7 


0 964 

U • Jut 


0 01 


U S KiJ 


A 


24. 


17896 


0 895 

U » W m* W 


0 33 




A 


25. 


2573 


0 943 


0 0 5 


n c; ir K 


A 


26. 


10486 

mm, V - W W 


0 857 


0 18 




A 


27. 


2^5 


0 899 

V • W m* ^ 


0 00 


nets 

US NC 


A 


26. 


2-717 


0 845 


n 43 




A 


29. 


2319 


0 849 


0 04 


nek r 


a 


v J t 


9915 


0 84 5 


0 17 


US i» w 


n 


31. 


215 


0.767 


0.00 


dskc 


B 


14. 


236 


0.877 


0.00 


fno d 


B 


15. 


6917 


3 .351 


0 47 




B 


18. 


3547 


3.543 


0 26 

V • mm W 


f nn a 


B 


19. 


13667 


3.435 


0.96 




B 


20. 


22013 


0.881 


0.39 


dskb 


B 


21. 


474 5 


0.863 


0.08 


dskb 


3 


22. 


6054 


0.861 


0.11 


dska 


B 


23. 


60 


0.925 


0.00 


dska 


B 


24. 


15946 


0.867 


0.28 


dska 


B 


25. 


989 


0.841 


0.02 


dska 


B 


26. 


12757 


0.863 


0.22 


dskb 


B 


27. 


1020 


0.903 


0.02 


dskb 


B 


28. 


5178 


0.838 


0.09 


dskc 


B 


29. 


30 


0.653 


0.00 


dskc 


3 




16582 


0.823 


0.28 


dskc 


B 


31. 


825 


0.841 


0.01 


dskc 


B 


32. 


1764 


0.825 


0.03 


dske 


Chan 


262506 


1.464 


7.82 




Ovhd 


258932 


0.230 


1.21 




Total 


258932 


1.713 


9.03 
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OUTPUT FRO", METERING COMMANDS 



file system meters 



E ' LE_SYSTEM_METERS " DISPLAYS MISCELLANEOUS METERING INFORMATION 
FOR THE F ! LE SYSTEM 



I ONLY PARTS RELEVANT TO SEGMENT CONTROL INCLUDED HERE; SEE TOPIC 
8 (PAGE CONTROL) FOR THE REST 



Total mete r ing time 0:20:02 



? ATE 



Lr t i V?T i ftp? 


1 Oh, *< 




1 z 3 


sec. 










segf a j 1 1 


969 


i . 


241 


sec . 


92. 


505% 


of 


a i 1 


makeknown 


74 


16- 


251 


sec . 


/ • 


095% 


of 


al 1 


c i rector i es 


96 


12. 


527 


sec . 


9. 


204% 


of 


si 1 


Deact i vat i ons 


1056 


1 . 


139 


sec . 










Demand deactivate 


















attemots 


3 


1*00. 


857 


sec . 










Sec Faults 


50BO 


0. 


237 


sec . 










"f aul t 




0. 


2^9 


sec . 


84. 


862% 


of 


Sec Fault 


cal ! 


765 


1 . 


56L 


sec . 


15. 


133% 


of 


Sec Fault 


ac t i vat i ons 


969 


1 . 


2 i i 


sec . 


19. 


075% 


0^ 


See Fault 


Bound F au i ts 


"20 


5- 


466 


sec . 










Setf aul ts 


4484 


268. 


191 


msec . 










access 


1*2 


28- 


633 


sec . 


0 . 




_ £ 


_ _ ». r _ . . -, „ _ 
au > l s 


ASTE Trickle 


139 


8. 


652 


sec . 










Steps 


4279 


281- 


01*0 


msec . 










Skips 


3016 


0. 


305 


sec . 


70. 


48<-% 


of 


Stecs 


ens 


i * 


L • 


438 


sec . 


£■ 


9851 


of 


Sk i PS 


men*. 


1083 


1 . 


i 10 


sec . 


35- 


909% 


of 


Skips 


i n i t 


1662 


0. 


72L 


sec . 


55- 


106% 


of 


S* i OS 


Searcnes 


0 


0. 


000 


sec . 










C 1 eanups 




1056 




1.139 


sec 




0. 1 


% of real 


Force wr i tes 


3 


1*00. 


857 


sec . 










pages wr i tten 


3 


400. 


857 


sec . 










Lock AST 


18422 


0. 


065 


sec . 
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OUTPUT FROM METERING COMMANDS 



file system meters 



AVE /lock % 
AST locked 4.833 msec. 7.4 

AST lock waiting 1.601 msec. 2.5 



AST Sizes 4 16 64 256 

Number 1701 601 221 74 

Need 819 202 208 34 

Steps 2341 645 1139 154 

Ave Steps 2.9. 3.2 5.5 4.5 

Lap Time(sec) 873.8 1120.5 233.3 577.9 



Not To Be Reproduced 



14-11 



F80A 



OUTPUT FROM METERING COMMANDS 



file system meters 



FILE_SYSTEM_METERS - DISPLAYS MISCELLANEOUS METERING INFORMATION 
FOR THE FILE SYSTEM 



| ONLY PARTS RELEVANT TO PAGE CONTROL INCLUDED HERE ; SEE TOPIC 7 
(SEGMENT CONTROL) FOR THE REST 



Total metering time 



0:20:02 



ATB 



Needc 


62654 


19 


.194 


msec . 


Ring 0 faults 




. 16 


.639 


% 


PDIR faults 




50 


.607 


% 


Level 2 faults 


21 


. 556 


% 


DIR faults 




7 


.645 


% 


New Pages 




14 


.661 


% 


Volmap_seg 


0 


0 


.000 


msec . 


Zero pages 


770 


1561 


.779 


msec . 


Laps 


105 


11 


.453 


sec . 


Steps 


361483 


3 


.327 


msec . 


Skip 


322555 * 


3 


.728 


msec . 


wi red 


11057 


108 


.761 


msec . 


used 


109719 


10 


.960 


msec . 


mod 


4 a m, •> »i r- 


n 
O 


tr r n 


msec . 


fc pin 


37717 


31 


.884 


msec . 


cl pin 


23726 


50 


.686 


msec . 


3419 pages, 1 


3 9 wired. 








Average steps 


5. 


770 







89.231% of SteDS 

3.428% of Skip 

34.016% of Skip 

/i-3 cnDo. ~ r e- u i ^ 

Ui JUU'o u j. o r\ a ±j 

11.693% of Skip 

7.356% of Skib 
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OUTPUT FROM METERING COMMANDS 



device meters 



8 DEVI CE_METERS - DISPLAYS SUMMARY OF I/O ACTIVITY FOR ALL DISK 
SUBSYSTEMS 



Total metering time 0:20:13 





dska 


dskb 


dskc 


dskd 


Prior Page I/O 


« 

18571 


17743 




462 


1273 


ATB 


65.334 


68.383 


2626 


,240 


953.121* 


Other Page I/O 


6525 


5135 




16 


696 


ATB 


185.949 


236.284 


75832 


.692 


1743.280 


ATB Page I/O 


48.347 


53.034 


2538 


.332 


616.212 


Prior VTOCE I/O 


934 


895 




38 


304 


ATB 


1299.061 


1355.668 


31929 


.554 


3991.194 


ATB I/O 


46.612 


51.037 


2351 


.401 


533.798 


% Busy 


76 


74 




0 


4 


Avg. Page Wait 


47.289 


46.197 


20 


.341 


24.666 


Avg. Page A Wait 


176.082 


101.023 


36 


.996 


61.704 


Avg VTOCE Wait 


41.138 


37.610 


38 


.595 


29.090 


Avq . Paae I /O T 


35.619 


38.314 


20 


.050 


22.482 


Avg. VTOCE I/O T 


31.139 


32.277 


37 


.060 


26.606 


EDAC Corr. Errs 


0 


0 




0 


0 


Errors 


0 


0 




0 


1 


Fatal Errors 


0 


0 




0 


0 
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OUTPUT FROM METERING COMMANDS 



disk meters 



» DISK_METERS - DISPLAYS I/O ACTIVITY TO DISK DRIVES 



(I ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 



Total metering time 0:20:12 



Subsystem dska 

call locks 
run locks 
interrupt locks 
allocations 



Drive 



Reads 



Count 

26005 
112 
25998 
26001 

Writes 



Waits 

217 
0 

239 




%Waits Avg. Wait(ms.) 

0.83 0.259 
0.00 0.000 
0.92 0.208 
0.00<3fto 0.000 



Seek ATB ATB 

Distance Reads Writes 



ATB 

I/O 



1 
3 
4 
5 
6 
7 
8 
9 
11 
12 
16 



269 
362 
309 
547 
631 
0 

5843 
366 
3501 
0 

7158 



67 
243 
131 
165 
165 
0 

2187 
lib 
1431 
0 

2508 



214 
109 
184 
180 
161 
0 

122 
153 
200 
0 

135 



4508 
3350 
3925 
2217 
1922 
0 

207 
3313 
346 
0 

169 



18102 
4991 
9258 
7350 
7350 
0 

554 
10455 
847 
0 

483 



3609 s ^ 
2004 
2756 
1703 
1523 
0 

1-51 
2516 
245 
0 

125 - vpf ^ ,;u 
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OUTPUT FROM METERING COMMANDS 



^ Of 



disk queue . 

\F YoO L 

■ DISK_QUEUE - DISPLAYS I/O QUEUE FOR A DISK SUBSYSTEM 

8 ONLY ONE SUBSYSTEM SHOWN HERE TO CONSERVE SPACE 

Connects = 2604781, 1359725, 677321, 309367, ^ l: 
123430, 40159, 10227, 1969. 



Lv/ /v 



P RW VP DV SECTOR 



MEM 




0 W P 24 1350330 27304000 

0 W P 9 1020150 4432000 

0 W . P 16 1204130 36246000 

0 W P 16 314370 27306000 

0 W P 16 314430 34166000 




yVu \Loij\J \*y* vo^'tc^l tUvx^U U>c Pack af<r> 



a 



5o ^1'^^ SisbSyfK*-)S Uk'V ^ew^^ry; 
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OUTPUT FROM METERING COMMANDS 



print configuration deck 



PRI NT_CONF I GURAT I ON_DECK - DISPLAYS >sll>con£ ig_dec k , WHICH 
CONTAINS INFORMATION ABOUT DISK LOCATIONS, THE RLV, AND PARTITIONS 



| ONLY THE PART OF THE CONFIG DECK RELEVANT TO VOLUME MANAGEMENT 
AND DISK CONFIGURATION IS SHOWN HERE 



root 


dska 


16. 


dskb 


25. dskb 23 


. 'dskb 


part 


bos 


dska 


16. 








part 


dump 


dska 16 








part 


log 


dska 


16. 








P r P h 


dska 


a 


20. 


2 


451. 16. 




chnl 


dska 


a 


26. 


2 


b 24. 2 b 


22. 2 


prph 


dskb 


b 


20. 


2 


0 16. 451. 


16. 


chnl 


dskb 


b 


26. 


2 


a 24. 2 a 


22. 2 


prph 


dskc 


a 


28.. 


2 


501. 32. 




chnl 


dskc 


a 


30. 


2 


b 30. 2 b 


28. 2 


prph 


dske 


b 


32. 


2 


451. 8. 




chnl 


dske 


b 


34. 


2 






prph 


dskf 


a 


32. 


2 


501. 16. 




chnl 


dskf 


a 


34. 


2 






mpc 


mspa 


451. 


a 


20 


. 4 a 24. 


4 


mpc 


mspb 


451. 


b 


20 


. 4 b 24. 


4 


mpc 


mspc 


607. 


a 


28 


4 




mpc 


mspd 


607. 


b 


28 


. 4 




mpc 


mspe 


451. 


b 


32 


. 4 




mpc 


mspf 


607. 


a 


32 


. 4 





ot To Be Reproduced 



14-16 



F80A 



OUTPUT FROM METERING COMMANDS 
print configuration deck 



5 DISK CONFIGURATION CONFIG CARDS 
g ROOT 

I IDENTIFIES THOSE VOLUMES IN THE ROOT LOGICAL VOLUME WHICH 
HAVE HC PARTITIONS, USED BY THE SUPERVISOR FOR PAGING OF 
SUPERVISOR SEGMETNS 

0 PART 

B IDENTIFIES THE LOCATIONS OF CERTAIN IMPORTANT PARTITIONS 

I ONLY PARTITIONS NECESSARY FOR MULT ICS OPERATIONS ARE 
IDENTIFIED, NOT ALT PARTITIONS 

8 HC PARTITIONS ARE LOCATED BY THE ROOT CARD 

| PRPH DSKn , CHNL 

8 IDENTIFY PHYSICAL I/O CHANNEL PATHS FOR ACCESSING DISK DRIVES 

1 MPC 

0 IDENTIFY PHYSICAL CONNECTIONS TO MICROPROGRAMMED DISK 
CONTROLLERS 
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OUTPUT FRQM METERING COMMANDS 



list VP 1 S 



E L ! 




VOLS - Dl 


SPLAYS 


A T 
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ONL I N 


SF 


ACE 


UT 1 L 1 2 AT 


1 ON 








Dr i ve 


Recoras 


Left 




VTOCEs 


Left 


dskc_ 


17 


64504 


54730 


85 


1341*0 


1 1356 


dskc_ 


16 


64504 


55389 


86 


1 3440 


1 1 352 


dska_ 


05 


36428 


5305 


15 


8400 


2662 


cska_ 


06 


36426 


4525 


12 


8400 


2365 


ds*b~ 


!9 


36428 


4632 


13 


8400 


2815 


dskb_ 


26 


36429 


13690 


38 


8400 


4526 


d s k b_ 


27 


36429 


4672 


* 


8400 


2333 


CSk=_ 


01 


36308 


4680 


13 


9000 

J W ta> w 


450 


CSke_ 


03 


36265 


55S8 


10 


9200 


1017 


GSke 


Oi4 


36268 


4500 


12 


9200 


884 


CSke_ 


09 


36263 


48 16 


13 


920c 


864 


GSKD_ 


17 


36269 


1*261 


12 


9200 


1002 


d s k b_ 




36266 


3840 


1 \ 


9200 


539 


cs kc_ 


15 


64504 


29L 


0 


1 3«40 




d s k c_ 


u 


64501. 


269 


0 


1 3440 


52 14 


dskc_ 


0 3 


64505 


4 3631 


68 


i 3^40 


10032 


C S k C_ 


C2 


64503 


4AA02 


7 1 


i 3440 


983E 

w u 


csk c_ 


03 


64503 


42 374 


66 


1 3«j40 


9839 


dskc~ 


04 


6450.} 


43591 


68 


1 3L40 


S785 


askc_ 


09 


64504 


56010 


90 


1 3440 


1239L 


dskc_ 


10 


64504 


567Si 


88 


1 3ti+0 


i 2 Li 0 7 


c s k c_ 


"21 


6 i* 5C3 


2^947 


37 


1 3^40 


61* 4 6 


cskc_ 


22 


64503 


*- *> / -u 14 


37 


1 3L40 


6 194 


dskc" 


'29 


64503 


2^794 


37 


1 3440 


6 1 B A 


cs*;c_ 


y- 


0 4 "< t' 


241 1 1 


37 


1 5440 


648 1 


dskc_ 


07 


6^503 


1172 3 


18 


1 3440 


6149 


CSkC_ 


OB 


6L5C5 


1 1665 


18 


1341<0 


6^29 


dskc_ 


23 


64504 


9777 


15 


13440 


6094 


dskc_ 


24 


64504 


1 1805 


18 


13440 


6141 


askc_ 


25 


64501+ 


1 1514 


18 


13440 


7407 


dskc_ 


26 


64504 


12958 


20 


13440 


7149 


Cske_ 


06 


37089 


8053 


22 


5100 


3797 


dska_ 


12 


37562 


6046 


16 


2735 


957 


dska_ 


07 


37309 


6825 


18 


4000 


2107 


cska_ 


08 


36209 


3827 


1 1 


7000 


491 


dska_ 


! 1 


36209 


8557 


24 


7000 


4181 


dska_ 


16 


31263 


2852 


9 


9000 


3476 


dskc_ 


23 


36208 


4888 


13 


7000 


455 


dskb_ 


24 


36209 


3C97 


5 


7000 


236 


dskb_ 


25 


36350 


4483 


12 


7000 


223 


Not Tc Be Reprocu 


ced 




u 


-18 



VOLUME 


S , THE 1 R 


LOCATION, 


AND 




% 


A VQ 


PV 


PB/PD 


I V N amp 






S i ze 
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84 


1, 


a 1 phaO 1 


nb 


Dd 
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84 


l, 
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ob 
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Dd 


M;i 1 * i r e 
t IU 1 L 1 us 


P . I ^> c 


35 
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pb 


DG 
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Di >K c 
r w w s 


52 


A 

j 


mu 1 05 


Db 


DC 


Mu 1 t i cs 


Pub ^ 


28 


A 


mu 1 04 


Db 


Dd 
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5 


3 


cubO 1 


nb 


Dd 


Pub 1 i c 




1 1 
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> 


pub07 


DD 


nc 


P 1 \ v\ } ! r 
r ui' ■ 1 w 




10 


3 


pubOl* 


cb 


n^ 


Pub 1 ! r 




9 


3 


pubQ2 


nb 


nn 


Pud 1 i c 




] 1 


X 


DubO^ 




nrt 
pa 


Pub 1 ! c 




A 

w 


3 


pubO£ 


Db 


nc 


P > 1 1 i r 




4 1 




r e 1 C 1 






pp 1 p. p r 0 






7 


re 1 02 






; ascc 
rv & i c G 3 c 






r 


xpubO 1 


Db 




n^UJ 1 1 _ 




73 




XDLlbu "5 

^ kp/ W W 4k. 


nb 








73 


C 
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^ k> U w ^ 


Db 




A U U w 1 1 w 




7 5 


*s 


x pub04 


cb 




Xpub 1 i c 




92 
✓ *• 


e 

D 


XDubO^ 

^% ^ w w ^ ^ 


Db 




Xpub 1 i c 




Q2 
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/ 


x DLinC A 

rf% ^ W W w U 


pu 




A p U LV 1 i L, 




48 


A 


voubO 1 


DD 




Youb ? i c 




46 


A 


vnuhu 7 


ob 

**** 








46 


A 


y dud05 


Db 




1 p W |J 1 1 l 




48 


A 


vsubOc 


nb 




V Dub ! i c 




46 


7 


ZDubO 1 


pb 


pa 


ZDub ! i c 




48 


7 


zpubC2 


DD 


Pd 


ZduD 1 i c 




45 

• 


7 


zpub03 


pb 


pd 


Zdud ? i c 




46 


7 


zpub04 


pb 


Pd 


Zpub 1 i c 




55 


8 


ZDubOA 


pb 


Pd 


Zpub 1 i c 




53 


8 


zpub06 


pb 


pd 


7nnh 1 i r 

«w p U LV 1 1 W 




74 


22 


1 i stOl 


pb 


pd 


list_l 




35 


17 


1 ist02 


pb 




i i st_2 




53 


16 


1 ist05 


pb 




1 i st_5 




7 


4 


rootS 


pb 




root 




60 


9 


root6 


pb 




root 




39 


5 


rpv 


pb 




root 




7 


4 


root5 


ob 




root 




3 


4 


root4 


pb 




root 




3 


L 


roct2 


DD 




root 





F80A 



OUTPUT FROM METERING COMMANDS 



traffic eontrol queue 

s TRAFF I C_C0NTR0L_QUEUE - DISPLAYS THE CURRENT CONTENTS OF THE 
SCHEDULER QUEUES, USEFUL FOR GETTING AN IDEA OF WHAT THE USER 
PROCESSES ARE DOING 



I FIRST PART OF OUTPUT IS ELIGIBLE QUEUE: 



avq = 13, 


elapsed time = 


1247 sec, 64 


act i ve 


last : 


15 sec. 






f 1 ags 


dtu 


dpf 


temax 


te 


ts 


ti 


tssc 


event d 


ws wc process 


rWLE (d) 


148 


6946 


2097 


37 


0 


0 


-0.001 


0 0 


6 


0 Initiali zer 


xLED (c) 


15 


1111 


1000 


910 


2012 


1897 


0.001 


0 0 


11 


6 Sibert 


rLE (d) 


14 


1370 


500 


89 


0 


0 


-0.009 


0 0 


0 


4 D 132 


rLE(d) 


15 


823 


500 


13 


0 


0 


-0.009 


0 0 


64 


8 JCrow 


wLE (d) 


13 


634 


500 


422 


0 


0 


0.018 


316537 0 


3 


3 G i nte 1 i 


xWLED (a) 


6 


108 


1000 


495 


2054 


2004 


0.010 


0 0 


13 


6 Brunei 1 e 


wLE (d) 


16 


864 


1000 


85 


0 


510 


0.016 


504031 0 


46 


6 WPeck 


wWLE (b) 


*68 


2734 


1000 


315 


3010 


8000 


0.015 


22J*£41 0 


4 


3 Scrati 


wLE (d) 


17 


656 


500 


60 


0 


0 


0.007 


1651H 0 


< 


L RTow 1 e 


wLE (b) 


12 


52C 


500 


50 


0 


0 


0.005 


71 0 


3 


3 Kress 


wLE (d) 


69 


1895 


500 


21 


0 


0 


0.001 


177022 0 


0 


2 OPCTL 


xLED (b) 


12 


• 872 


500 


85 


0 


0 


0 = 005 


0 0 


0 


3 Pandolf 


rLE (dV 


67 


3279 


500 


0 


0 


0 


-0.006 


0 0 


0 


3 Lackey 
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OUTPUT FROM METERING COMMANDS 
traffic control queue 



I SECOND PART IS REALTIME, INTERACTIVE p AND ALL WCRKCLASS QUEUES: 



REALTIME QUEUE: 
INTERACTIVE QUEUE: 



unpvrT ice 


c, 


OTTPTTTT • 


creci uS 




o / d ms . 














WORKCLASS 

^ * 


3 

28S 
131 


QUEUE: 
5326 
2513 


• 

credits 
1000 
1000 


0 
0 


242 ms. 

0 503 
4010 8000 


0 
0 


.218 
.12B 


0 
0 


0 
0 


22 
0 


3 
3 


WORKCLASS 


4 


QUEUE: 


credits 




2601 ms. 














WORKCLASS 


5 


QUEUE : 


credits 




4000 ms. 














WORKCLASS 


6 


QUEUE: 


credits 




-563 ms. 














WORKCLASS 
rW 


7 
5 


QUEUE : 
166 


credits 
500 


0 


3962 ms. 

0 0 


c 


.192 


0 


0 


2 


7 


WCRKCLASS 


6 


QUEUE : 


credits 




3934 ms. 














WORKCLASS 


Q 


QUEUE : 


credits 




2216 ms . 
















i n. 


r\TTr"-Ttr . 


T» A t% 1 *■ e 




4 000 ms . 














WORKCLASS 


11 


QUEUE : 


credits 




4000 ms. 















Dupuis 
Falksen j 
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OUTPUT FROM METERING COMMANDS 



traffic control meters 



B TRAFFIC CONTROL METERS - DISPLAY THE STATE OF THE SCHEDULER 



8 OUTPUT COMES IN THREE PARTS, SHOWN OUT OF ORDER HERE: 



8 QUEUE LENGTHS AND RESPONSE TIME - THESE ARE WEIGHTED AVERAGES 
OVER THE LAST FIFTEEN SECONDS. 



8 ACTIVITIES VERSUS DEPTH - HOW DEEP THE TRAFFIC CONTROLLER HAD 
TO SEARCH TO FIND A SCHEDULABLE PROCESS 



8 MISCELLANEOUS COUNTERS AND FREQUENCIES OF VARIOUS EVENTS 



Total metering time 0:20:34 

Ave queue length 16.52 
Ave eligible 13.31 
Response time 0.264 sec 



DEPTH 



%PF 



TBPF 



%GTW 



TBS 



%CPU 



1 

2 

3 
4 
5 
6 
7 
8 



12.0 22.8 

11.8 21.0 

10.8 24.9 

10.2 27.9 

9.5 29.8 

8.4 33.5 

7.4 36.3 

30.0 48.6 



10.8 
9.2 
8.7 
8.5 
8.3 
7.8 
7.3 

39.5 



11.6 8.1 

12.2 7.4 

14.1 8.0 

15.2 8.4 
15.5 8.4 
16.5 8.4 
16.8 8.0 
16.8 .43.3 
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OUTPUT FROM METERING COMMANDS 



traffic control meters 



COUNTER TOTAL 

Interactions 7977 

Loadings 12161 

Blocks 14082 

Wakeups 36078 

Schedulings 12591 

Lost priority 1 

Priority boosts 0 

I/O boosts 578 

Wait Page 127040 

Wait PTL 75691 

Wait Other 31912 

Total Waits 234643 

Notify Page 128954 

Notify PTL 75691 

Notify Other 25330 

Total Notifies 229975 

Get Processor 245856 

Pre-empts 94235 

Getwork 338802 

Retry getwork 4988 

Extra notifies 2949 

Last EN event 0000001 

Last NTO event 033022: 





ATB 


#/INT 


0. 


155 


sec 




0 . 


102 


sec 


1 . 525 


0. 


088 


sec 




0. 


034 


sec 




0. 


098 


sec 


1 . 578 


1234 . 


756 


sec 




0\ 


000 


sec 




2. 


136 


sec 




9. 


719 


msec 


15 . 926 


16 . 


313 


msec 


9.489 


38 . 


693 


msec 


4. 001 


5. 


262 


msec 


29.415 


9. 


575 


msec 




16. 


313 


msec 




48. 


747 


msec 




5. 


369 


msec 




5; 


022 


msec 




13. 


103 


msec 


11.813 


3. 


644 


msec 




0. 


248 


sec 




0. 


419 


sec 





00071 
37767 



B ALARM_CLOCK_METERS - DISPLAYS INFORMATION ABOUT THE USER ALARM 
TIMER FACILITY (HARDCORE INTERFACE FOR t imer_manager_) 



Total metering time 0:20:31 

No. alarm clock sims. 2171 

Simulation lag 5.245 msecs. 

Max. lag 1.7340314e4 msecs. 
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OUTPUT FROM METERING COMMANDS 



print tuning parameters 



s PHI NT_TUNX NG_PARAMETERS - PRINT VALUES FOR SYSTEM CONTROL 
PARAMETERS. MOST CONTROL THE SCHEDULER 



Current system tuning parameters: 



tef irst 

telast 

timax 

priority sched_inc 

min_eligTble 

max_eligible 

max_batch_elig 

working_set_f actor 

working__set_addend 

deadl i ne_mode 

int_q_enabled 

post_purge 

pre_empt_sample_t ime 
gp_at_notify 
gp_at_ptlnoti f y 
process initial ejus n rum 
quit_pr iority 
gv_integration 
realtime_i o_p r i o r i : y 
realt ime_io_deadline 
realtime_io_quantum 
not i f y_t imeout_i nterval 
not if y_timeout_sever i ty 
write limit 



0. 5 seconds 

1. seconds 
8. seconds 
80. seconds 
2. 

20. 
0 

0.5 
0 

off 

on 

on 

0.04 seconds 

off 

off 

2 . seconds 

o! 

4. seconds 
on 

0. seconds 
0.005 seconds 
30. seconds 

0 

724 



8 THESE ARE "INTERNAL", NORMALLY NEVER CHANGED , AND ONLY PRINTED 
IF THE -all CONTROL ARGUMENT IS GIVEN 



stack_truncat ion on 

stack~truncation_always off 

stk_trunc_block_avg_f actor 0.25 

trap_invalid_masked off 

meter_ast_locking off 

checksum_f ilemap on 
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OUTPUT FRQ,*, METERING COWHANDS 



work class meters 



E WORK_CLASSJ*ETERS - DISPLAY THE VARIOUS WQRKClASS PARAMETERS , AND 
SHOW~WHAT RESOURCES EACH WORKCLASS IS CONSUMING. 



Total metering time 0:20:38 

WC %GUAR %MAX %TCP V/ELIG PW IRESP I QUANT RESP QUANT P M R I LCG 



0 






3. 


0.12 3 


0.26 -2.10 0.26 2.10 


P 


0 


1 






3- 


0.05 1 


0.25 0..75 0.50 1.00 


p 


0 


2 


7 • 




15. 


O.U 1 




P 


0 


:> 


32. 




kk. 


0.1*9 l 


* 


P 


0 


1* 


9- 


u. 


k. 


0.26 1 




P 


0 


5 


20. 




2. 


0.1*6 1 




P 


0 


& 


12. 


lb- 


8. 


0.25 1 




P 


0 


-i 

/ 


3- 


7. 


u. 


0.36 1 




P 


0 


6 


6- 




0. 


0.18 1 




P 


0 


5 


L . 


8. 


£ . 


0.62 1 




F 


0 


10 






0. 


0.55 l 




P 


0 


• i 






2 . 


0.16 1 




P 


0 


TCFU 


percents 


(%GUAR) 


control 


non-realtime work_classes 







R I 1*1 i t 
R I RT i me 

I System SysAdm OPR FE! 

I SysProg SysDev 
SEncr 



HEngr 

MktUS MktFor 

DS-CC 

Of f Auto 

rise Mfg 

Other 

Soec i a 1 



rktEc' 
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OUTPUT FROM METER I NG COMMANDS 



respons meters 



» RESPONSE METERS - DISPLAYS RESPONSE TIME, BASED ON TERMINAL 
INTERACTIONS, ON A PER-WORKCLASS BASIS 



Total metering ti 

WC —-Thinks/— 

Queues 

# Avg 

0 86 2.70 
92 0.15 



35 11.78 
39 0.21 



553 14.90 
612 0.15 



3 2496 6.36 
2622 0.17 



k 581 15-82 
590 0.26 



133 29.51 
HI 0.17 



0:20:36 

Response Times 

-VCPU Range- # 

From To Int 

0.00 0.50 113 

0.50 1.00 3 
1.00 10.00 3 
119 

0.00 0.50 34 

0.50 1.00 , 2 
--— 36 

0.00 C.50 620 

0.50 1.00 28 

1.00 10.00 39 

CQ~! 

UVJ 

0.00 0.50 2993 

0.50 1.0c 117 

i.00 10.00 66 

10.00 99.99 10 

-— 3186 

0.00 0.50 663 

0.50 l.OC 13 

1.00 10.00 8 
684 

0.00 0.50 148 

0.50 1.00 3 

1.00 10.00 5 

10.00 99.99 2 
158 



by VCPU Range— 7- 



Avg 


Avg 


Resp 


VCPU 


RT 


Fact 


0.04 


0.42 


9.34 


0 .55 


5.51 


10.00 


2.43 


14.96 


6. 15 


0. 12 


0.91 


7-76 


0.11 


0.96 


8.74 


0.83 


4.06 


4.87 


0. 15 


1.13 


7.55 


0.05 


0.43 


10.50 


0.71 


3 - 6 J 


5. 10 


1.77 


8-39 


4.74 


n 1 7 
— • - / 


1 D7 

i . w / 




0.08 


0.66 


7.96 


0.68 


4.22 


6.16 


2.46 


13.47 


5-49 


56.85 


93.33 


3.33 


0.33 


1.65 


4-96 


0.05 


0.71 


12.54 


0.64 


4.64 


7.30 


3.47 


32.07 


9-24 


0.11 


1.15 


10.88 


0.06 


0.83 


12.95 


0.69 


4.64 


6.70 


3.15 


10.24 


3.25 


26.69 


48-84 


1.83 


0.51 


1.81 


3.55 



Load Control Group 



Ini t 



RTime 



System SysAdm GPR 



SysProg SysDev 



Stngr 



HEngr 



Not To Be Reproducso 



14-25 



OUTPUT FROM METERING COMMANDS 



respons meters 



1180 11.65 0.00 0.5C 977 0.05 1.13 20.91 MktUS MktFor MktEd 

1211 0.5E 0.50 1.00 24 0.64 4.95 7.74 

1.00 10.00 16 1.89 11.88 6.29 

— — — 1017 0.10 1.39 14.38 



7 259 


14 


.65 


0.00 


0.50 


292 


0.08 


1.53 


20.17 


DS-CC 


287 


0 


.98 


0.50 


1.00 


9 


0.71 


9.03 


1-2.66 










1.00 


10.00 


17 


2.04 


14.76 


7.24 










10.00 


99.99 


1 


12.22 


99.99* 


9.45 














319 


0.24 


2.81 


11.86 




8 73 


2 


.69 


0.00 


0.50 


79 


0.06 


0.31 


5.45 


Of f Auto 


74 


0 


.05 


0.50 


1.00 


2 


0.60 


6.40 


10.62 










1.00 


10.00 


1 


3.20 


6.73 


2.10 














82 


0.11 


0.54 


4.94 





9 


94 


41.91 


0.00 


0 . 50 


80 


0.11 


1.23 


11.07 Misc 




96 


0.30 


0.50 


1.00 


11 


C.69 


4.74 


6.91 








1.00 


10. CO 


13 


2.99 


12.82 


4.30 












104 


0 . 53 


3.05 


5.74 



* U 


7 


99. 


99 


0.00 


c. 


50 


10 


0.11 


1.45 


13.62 




6 


C. 




1.00 


10. 


00 


1 


3.88 


39.11 


10.09 
















11 


0.45 


4.88 


10.89 


1 1 


417 


12. 




0.00 


0. 


50 


445 


0.03 


0.50 


15.32 




420 


0 . 


16 


n cn 


1. 


00 




0.57 


3.61 


6.29 










1.00 


10. 


00 


4 


1.65 


1-1.40 


6.90 
















454 


0.05 


0.63 


11 .93 


All 


5954 


11 . 


13 


0.00 


0. 


50 


6454 


0.07 


0.77 


11.40 




6192 


c. 


29 


0.50 


1 . 


00 


217 


0.68 


4 . 54 


6.70 










1.0C 


10. 


00 


173 


2.31 


13.11 


5.68 










10.00 


99. 


99 


13 


48.77 


99.99 


3 . 32 
















6857 


0.24 


1.51 


6.39 



86797 calls to meter_response_t ime 283 invalid transitions. 

Overhead = 0.09% ( 0.052 ms./call) 
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OUTPUT FROM METERING COMMANDS 



system performance graph 



8 SYSTEM_PERFORMANCE_GRAPH - GIVES 
ACTIVITY, SAMPLED PERIODICALLY 



> 

up= 04/01/83 



A ROUGH 



SNAPSHOT OF 



04/02^83 1114.3 est 
OS 55.6 est, sys_hours= 26 . 3 , \|cpi__hours- 78.9 



cpu= 3 , pages* 3419, min_e= 3, max_e= ±6, 
tefirst= 0.13. telast= 0.50. timax= 32. 



tef i rst 

1115.00 Qe^U^l^ 

1116.00 Qe .**** 

1117.00 Q*e******* 

1118.00 Q*e******* 

1119.00 Qe******** 

1120.00 Qe******** 

1121.01 Q*e******* 
1122.00 Qe******** 
1123.00 Qe******** 
1124.00 Q* e ******* 
1125.00 Q* e ******* 
1126.00 Q* e ******* 
1127.00 Q* e ******* 



.13, telast= 0.50, timax= 32.(1 

******* j **+****** | ******u 1 k tpS y 
********* | ********* | **i i its) y 
***iittpp| + . y| . 



1129:00 Qe ******* 
1130.00 Qe ******* 
1131.00 Qe ******* 
1132.00 Qe******** 
1133.00 rQ******** 
1134.00 Qe******** 
1135.00 Qe 
1136.00 Qe******** 

1137.00 rQ******** 

1138.01 Qe******** 
1139.00^e^* v **^*U|J 

r Q******** ** 5 : 



1140.0: 



^1 



SYSTEM 



Sat 

wsa= 0, wsf = 0.50, 



ttpp| 

*******i ittps+. y j 

********* |*** + *ii t jy 
********* | ***+**£ £ Jy 
******ij£pp + y | 

********* j****+iitp|y 
********* j **mi+ts y 
********* j * i i i+ps |y 
********** m i j. i+tps jy 

****iiiit | tps+. y j 
********* j*ii+tp yj 

********* j *+* + * i :: tt p 

********* j***j-*****j****^ i t tp 
********* j***l***** i **i i i ttp 
********* j ***!***** j ****iiitt 
********* |***I***** j ****iiit 
********* j **^y***** | * i i i tts y 
********* j **x****** j *** i itp y 

******* ! **!***** * j ********i^£ 
********* j ***V****** i i i tts y| 
********* j***4***** j ****iitts |y 
********* I*** J*****iiii t p 
********* j ****+*****t itps 
J * ****** | ***-^*****^^ i t tpp 



y 
y 
y 



r •' lr i T iT' / / 

1 b<^th / 



-\J\al v(o 
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OUTPUT FROM METERING COMMANDS 
system performance graph 



SOME CHARACTERS INDICATES PERCENTAGES OF SYSTEM TIME SPENT IN 
VARIOUS ACTIVITIES. OTHERS INDICATE ACTUAL VALUES 



fl PERCENTAGES 

| BLANK - USER PROCESSING. RING ZERO TIME BETWEEN "y" AND 
THE RIGHT MARGIN, USER RING BETWEEN "s" and "y" 

fl SYSTEM SERVICES - SEGMENT FAULTS ("s"), PAGE FAULTS ("p"), 
TRAFFI C CONTROL ( " t " ) , I NTERRUPTS ("" i " ) 

0 IDLE TIME - MP IDLE (V), NMP IDLE ("*"), ZERO IDLE 
(BLANKS ON THE LEFT) 



0 OTHER VALUES (RELATIVE TO THE LEFT MARGIN) 

0 TRAFFIC CONTROL QUEUE LENGTHS - READY QUEUE ("q"), 
ELIGIBLE QUEUE (V) 

0 USER COUNTS - NUMBER OF USERS ("+"), LOAD UNITS ("-") 

| TRAFFIC CONTROL VALUES - RESPONSE TIME (V) r QUITS PER 
MINUTE ("Q n ) r S'CHEDULINGS IN TEN SECONDS. ("S") 



jj OTHER VALUES .(RELATIVE TO THE RIGHT MARGIN) 

J I/O TRAFFIC - DISK I/O PER 100 MILLISECONDS ( "D" ) , VTOC 
I/O PER 100 MILLISECONDS ( n V ) 
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OUTPUT FROM METERING COMMANDS 
meter gate 



e METER GATE ~ SHOWS TIME SPENT CALLING THROUGH SUPERVISOR GATES 
(HCS , ETC.) 



Metering since 01+/0 1/83 0855.6 est Fri. 

Total non-idle time at 04/02/83 1101.9 est Sat * 39 *r. 36 min. 57 sec. 
Gate meters for hcs_: total calls'* 6294028- 



hr . 35 


min. 54 


sec 


or 


19 1R02: 


enent in cal 1 e Throunh 

d^wl 1 t 111 wS 1 Id will UUU1 1 


cal 1 s 


pent 


avg 


pwa i t 


CI I w, * J 1 tOujw 


902768 


4 


50 


7 


11 


0 .02 


ttv wr i te 


13857 


2 


29 


236 


01 


2 .28 


1 i st d i r 


4L29 12 


1 


19 


3 


85 


0.01 


t"t" v road 

1 wa w 


435510 


1 


01 


3 


30 


0 .02 


tt v order 


165 154 


0 


97 


8 


35 


0 . 10 


i n i T i ate 


120204 


0 


83 


5 


84 




mat a nf r 

lllan w ^ LI 


20620 


0 


51 


34 


55 


0 iiP 


ma Up ton 




0 


50 


1 1 


69 


0.14 


1>1 UI1W6 Uw wwW 




0 


45 


14 


25 


0 1 A 


statue 1 nnn 


3376 15 


0 


40 


1 


69 


0 .0 1 


set alarm tiTi°r 


532081 


c 


35 


0 


95 


0.00 


read evenT^ 


4085 


0 


35 


122 


90 


3 . 57 


star d i r list 


42080 


0 


33 


1 1 


17 


0 .02 


list ac 1 


59354 


0 


32 


7 


76 


0.01 


status for hackL-n 


103029 


0 


32 


4 


.44 


0.03 


ttv net 1 i ne 

^ LJ w WW 1 1 1 1 w 


61851 


0 


32 


7 


33 


0.03 


tty_wr i te_whol e_str i ng 


48621 


0 


31 


9 


05 


0.35 


status_minf 


31637 


0 


26 


1 1 


64 


0.04 


set_max_l ength_seg 


150703 


0 


26 


2 


41 


0.03 


term i na te_ncr.ame 


67267 


0 


20 


4 


19 


0.03 


tty_read-_echoed 


14851 


0 


20 


18 


77 


0.08 


quota_get 


21051 


0 


18 


12 


.48 


.0.72 


get_l i nk_target 


30337 


0 


18 


8 


25 


0.40 


:ni tiate^count 


6288 


0 


17 


39 


36 


0.25 


de 1 entry^seg 


247420 


0. 


16 


0 


95 


0.03 


wakeup 


14024 


0 


16 


15 


99 


0.43 


status_ 


476759 


c 


16 


0 


47 


0.00 


level_set 


13601 


0 


13 


13 


69 


0.00 


di r_quota_read 


14860 


0 


13 


12 


05 


0.02 


list d i r ac 1 


13496 


' 0 


13 


13 


22 


0.01 


get_max_l ength 


28194 


0 


12 


6 


15 


0.41 


make_entry 


23725 


0 


1 1 


6 


65 


0.09 


set_bc_seg 


1416 


0 


1 1 


108 


00 


2.08 


star_ 


13941 


0 


10 


10 


6S 


0.40 


get_access_c 1 ass 


28696 


0 


10 


c 


03 


0.04 


status_m i ns 


13553 




no 


c 


76 


0.C2 


1 i st_i nac l_a 1 i 
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OUTPUT FROM METERI NG COMMANDS 



meter gate 



128B1 0.08 8.50 

46180 0.08 2.33 

206 , 0.07 493.77 

1109005 0.07 0.09 



0.39 get__user_e£f mode 

0.01 tty_read~with mark 

3.79 star_list_ 

0.00 level_get 
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OUTPUT FROM METERING COMMANDS 



meter gate 



I HPHCS_ AND i 0 i ARE THE OTHER SUPERVISOR GATES THAT CONSUME 

SIGNIFICANT RESOURCES 



Metering since 04/01/83 0855*6 est Fri. 

Total non-idle time at 04/02/83 1102.7 est Sat * 39 hr. 37 "tin. 59 sec 

Gate meters for hphcs_: total calls*= 70604. 

0 hr. 29 mi n. 51 sec. or 1.256% spent in calls through gate. 

calls pent avg pwait entry name 



869 


0 


• 57 


928 


.77 


5-40 


destroy_process_f i ni sh 


911 


0 


.24 


381 


.04 


15.09 


create_proc 


5944 


0 


.20 


48 


• 34 


1.04 


di r_quota_read 


8326 


0 


.05 


8 


.47 


0.04 


tty_wr i te_f orce 


5946 


0 


• 05 


11 


• 31 


0.00 


quota_read 


105 


0 


.04 


500 


.68 


0.00 


flush_core 


246 


0 


.04 


208 


• 83 


■ 0.17 


f lush_ast_pool 


1753 


0 


.02 


16 


.94 


0.76 


star_ 


5595 


0 


.02 


4 


.12 


0.00 


set_backup_dump_t i me 


31893 


0 


.01 


0 


.60 


0.00 


set_kst__attr i butes 


1- 


0 


.01 


14598 


• 71 


8.00 • 


ada_scu 



Metering since 04/01/83 0855-6 est- Fri. 

Total non-idle time at 04/02/83 1103.0 est Sat = 39 hr. 38 min. 22 sec. 

Gate meters for ioi_: total calls = 245985- 

0 hr. 12 min. 14 sec. or 0.515% spent in calls through gate. 



ca 1 1 s 


pent 


avg 


243976 


0.50 


2.94 


248 


0.01 


65-91 


793 


0.00 


0.58 


533 


0.00 


0.54 


322 


0.00 


0.59 


105 


0.00 


0.55 


3 


0.00 


4.38 


5 


' 0.00 


0.65 



pwait entry name 

0.00 connect 

2.09 workspace 

0.00 get_spec i al_status 

0.00 set_event 

0.14 set_status 

0.00 timeout 

0.00 set_channel_requ i red 

0.00 get_deta i 1 ed_status 
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15-i F80A 



CONVENTIONAL MEMORY 



STRUCTURE 



B 1 -DIMENSIONAL ADDRESS SPACE USED BY THE SYSTEM 
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F80A 



CONVENTIONAL MEMORY 



CHARACTERISTICS 



SPACE DIVIDED INTO REGIONS OF VARIOUS SIZES, ONE REGION PER 
PROCESS/JOB/USER 



b REGIONS ARE: 



| PROTECTED FROM ONE ANOTHER BY A BAR OR BY PROTECT KEYS 



SUBDIVIDED INTO POOLS OF STORAGE USED FOR: PROGRAMS, I/O 
BUFFERS, MEMORY ALLOCATION AREA, AUTOMATIC VARIABLES, STATIC 
VARIABLES 



B 1 -DIMENSIONAL ADDRESS SPACE WIRED DIRECTLY ONTO REAL MEMORY 



B PROGRAMS MUST BE LOADED INTO REAL MEMORY 



| MEMORY ALLOCATION FOR REGION 



0 PROGRAMS AND BUFFERS ALLOCATED WITHIN REGION 



PREPARATORY ADDRESS MODIFICATION (ADDRESSES MUST BE MODIFIED TO 
REFLECT LOCATION WITHIN THE REGION) 
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CONVENTIONAL MEMORY 



CHARACTERISTICS 



B LINKAGE EDITING REQUIRED 



0 ALL SYMBOLIC REFERENCES MUST BE RESOLVED - IMPLYING THAT ALL 
REFERENCED PROGRAMS MUST BE LOADED REGARDLESS OF WHETHER OR NOT 
THEY ARE ACTUALLY NEEDED AT RUN TIME 



8 EXAMPLES: GCOS , IBM OS/MFT, IBM OS/MVT 
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CONVENTIONAL MEMORY 



PROBLEMS 



SYSTEM ADDRESS SPACE LIMITED TO SIZE OF REAL MEMORY 



USER ADDRESS SPACES (REGIONS) ARE SMALL. THIS MEANS: 



0 PROGRAMS MUST BE WRITTEN TO FIT INTO SMALL REGIONS 



0 SMALL REGION PROGRAMS OFTEN OPERATE LESS EFFICIENTLY IN THEIR 
USE OF CPU TIME THAN A SIMILAR PROGRAM DESIGNED FOR A LARGE 
REGION 



BECAUSE SMALL REGION OPERATION IS PROGRAMMED IN, SUCH PROGRAMS 
CANNOT TAKE ADVANTAGE OF MORE MEMORY WHEN IT CAN BE MADE 
AVAILABLE 



PROGRAMMER MUST WASTE INGENUITY (AND SYSTEM RESOURCES) TO MAKE 
PROGRAMS RUN IN A SMALL REGION: 



| WRITING OVERLAY PROGRAMS 

0 DIVIDING REGION INTO OPTIONAL-SIZE POOLS 



PROGRAMMING MECHANISMS TO EXTEND OR SWAP-OUT POOLS WHEN THEY 
OVERFLOW 



D PROGRAMMER TIME WASTED WHEN PROGRAMS MUST BE CONVERTED TO TAKE 
ADVANTAGE OF LARGER REGIONS WHEN CONFIGURATION IS INCREASED 
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F80A 



CONVENTIONAL MEMORY 



PROBLEMS 



a REAL MEMORY IS USED INEFFICIENTLY 



D WITHIN A REGION, PROGRAM COMPONENTS OR DATA AREAS NOT REFERENCED 
STILL OCCUPY. REAL MEMORY 



1 UNUSED SPACE BETWEEN REGIONS WASTES REAL MEMORY (FRAGMENTATION) 



8 SCHEMES FOR USING REAL MEMORY MORE EFFICIENTLY ARE COSTLY 



I CPU COST OF MOVING REGIONS TO REDUCE FRAGMENTATION 



| CPU AND I/O COSTS TO SWAP OUT ENTIRE REGIONS TO SHARE REAL 
MEMORY AMONG MORE USERS 



8 NO PROTECTION OF DATA WITHIN A REGION 



1 PROGRAMMING ERRORS CAN CAUSE UNWANTED WRITING INTO PROGRAM OR 
DATA AREAS 
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CONVENTIONAL MEMORY 



PROBLEMS 



b OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 



B NO SHARING OF PROGRAMS AND DATA BETWEEN REGIONS 



jj EACH REGION MUST CONTAIN A COPY OF SHARED DATA (INEFFICIENT USE 
OF MEMORY) 



0 MODIFICATIONS TO SHARED DATA CANNOT EASILY BE REFLECTED IN ALL 
COPIES 



B PHYSICAL INPUT/OUTPUT OPERATIONS ON DISK FILES OFTEN BECOME THE 
RESPONSIBILITY OF THE PROGRAMMER (REDUCING PRODUCTIVITY) 
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SINGLE VIRTUAL MEMORY 



STRUCTURE 



B A LARGE ADDRESS SPACE USED BY THE SYSTEM (EG, 4M WORDS) 



B THE ADDRESS SPACE IS LOGICALLY DIVIDED INTO REGIONS OF VARIOUS 
SIZES, AS IN CONVENTIONAL MEMORY 



B THE VIRTUAL MEMORY IS PHYSICALLY DIVIDED INTO PAGES HAVING A FIXED 
SIZE 



B THE ADDRESS SPACE AND THE VIRTUAL MEMORY HAVE THE SAME SIZE 



B THE 1 -DIMENSIONAL ADDRESS SPACE IS MAPPED DIRECTLY ONTO THE PAGED, 
1 -DIMENSIONAL VIRTUAL MEMORY 



B THE VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO A SMALLER 
(EG, 256K WORDS) REAL MEMORY 



B PROGRAMS MUST BE LOADED INTO THE VIRTUAL MEMORY AS IN CONVENTIONAL 
MEMORY SYSTEMS 
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F80A 



SINGLE VIRTUAL MEMORY 



CHARACTERISTICS 



£ LINKAGE EDITING REQUIRED AS IN CONVENTIONAL MEMORY SYSTEMS 



a EXAMPLES : 



0 IBM OS/VS-1 OR OS/VS-2 RELEASE 1 
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SINGLE VIRTUAL MEMORY 
SOLVE D PROBLEMS 

g THE SYSTEM'S ADDRESS SPACE IS MUCH LARGER THAN REAL MEMORY 

0 THE ^SYSTEM CAN RUN MORE AND/OR LARGER USER REGIONS 

8 THE USER REGIONS CAN BE LARGER 

| PROGRAMS CAN BE WRITTEN FOR A LARGE REGION TO TAKE ADVANTAGE OF 
ADDITIONAL MEMORY WHEN IT IS AVAILABLE 

s PROGRAMMER PRODUCTIVITY IMPROVES 

| PROGRAMMERS WORRY LESS ABOUT OPTIMIZING MEMORY USAGE 

1 CONVERTING PROGRAMS TO USE LARGER MEMORY CONFIGURATIONS OFTEN 
UNNECESSARY - LESS COMPETITION 

B REAL MEMORY USED MORE EFFICIENTLY 

• 1 FEWER UNREFERENCED AREAS OF ADDRESS SPACE OCCUPY REAL MEMORY 
0 PAGING ALGORITHM SIMPLIFIES MEMORY MANAGEMENT SCHEMES 
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SINGLE VIRTUAL MEMORY 



PROBLEMS 



MEMORY SWAPPING MAY STILL BE NECESSARY TO SHARE THE ADDRESS SPACE 
AMONG MANY USERS 



USER REGIONS STILL TOO SMALL TO HANDLE EVERY APPLICATION. SOME 
MEMORY MANAGEMENT STILL REQUIRED 



B NO PROTECTION OF DATA WITHIN A REGION 



E OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 



£ NO SHARING OF DATA BETWEEN REGIONS 



E EXPLICIT DISK I/O STILL REQUIRED TO ACCESS FILES 



B THE ADVANTAGES OF SOLVING THE PROBLEMS ABOVE MAY BE OUTWEIGHED BY 
COSTS IN HARDWARE AND SOFTWARE OF THE PAGING OVERHEAD 
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MULTIPLE VIRTUAL MEMORIES 
STRUCTURE 



8 THE SYSTEM USES MANY LARGE (4M WORD) , 1 -DIMENSIONAL ADDRESS SPACES, 
ONE PER USER REGION 



B EACH ADDRESS SPACE CONTAINS THE SUPERVISOR PROGRAMS PLUS ONE LARGE 
USER REGION (DIVIDED INTO POOLS), PLUS PROGRAMS AND DATA SHARED 
AMONG ALL REGIONS 



B EACH ADDRESS SPACE IS MAPPED DIRECTLY ONTO ITS OWN, PAGED VIRTUAL 
MEMORY 



B EACH VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO THE 
SINGLE, SMALLER REAL MEMORY 



B PROGRAMS MUST BE LOADED INTO THE VIRTUAL MEMORY AS IN CONVENTIONAL 
MEMORY SYSTEMS 



B LINKAGE EDITING REQUIRED AS IN CONVENTIONAL MEMORY SYSTEMS 
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F80A 



MULTIPLE VIRTUAL MEMORIES 



CHARACTERI STI CS 



EXAMPLES l 



S IBM OS/VS-2 RELEASE 2 (MVS) 
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MULTIPLE VIRTUAL MEMORIES 



SOLVED PROBLEMS 



B THE LARGE USER REGIONS CAN HANDLE ALL BUT THE LARGEST PROGRAMS 
WITHOUT SPECIAL MEMORY MANAGEMENT * PROGRAMMER MUST STILL DIVIDE 
REGIONS INTO POOLS, HOWEVER, AND SOMETIMES PROVIDE POOL OVERFLOW 
MECHANISMS 



B MEMORY SWAPPING IS NOW UNNECESSARY. PREVIOUSLY SWAPPED REGIONS NOW 
OCCUPY THEIR OWN ADDRESS SPACES AND ARE PAGED IN AND OUT 



B PROGRAMS AND DATA (USUALLY READ-ONLY) CAN BE SHARED BETWEEN REGIONS 
IN A LIMITED WAY BY OCCUPYING THE SAME POOL IN EVERY ADDRESS SPACE 



B NEWLY SOLVED PROBLEMS MAKE PAGING OVERHEAD MORE WORTHWHILE 



Not To Be Reproduced 



15-13 



F80A 



MULT I PLE 



VI RTUAL MEMORIES 



PROBLEMS 



B NO PROTECTION OF DATA WITHIN THE MAJORITY OF A USER'S ADDRESS SPACE 
(REGION) 



B OVERHEAD AND INCONVENIENCE OF LOADING AND LINKAGE EDITING 



B GENERAL SHARING OF READ-WRITE DATA STILL NOT POSSIBLE 



B EXPLICIT DISK I/O STILL REQUIRED TO ACCESS FILES 
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F80A 



MULTICS VIRTUAL MEMORY 



STRUCTURE 



B THE SYSTEM USES MANY, VERY LARGE {EG, 256M WORDS), 2 -DIMENSIONAL 
ADDRESS SPACES, ONE PER USER PROCESS (REGION) 



B EACH ADDRESS SPACE IS DIVIDED INTO SEGMENTS WHICH PERFORM THE SAME 
FUNCTION AS POOLS IN MULTIPLE VIRTUAL MEMORY SYSTEMS 



B SEGMENTS § 



1 HAVE VARYING SIZES 



| ARE EXTENDABLE 

fl ARE FILES IN THE MULTICS STORAGE SYSTEM 



ARE ACCESSED AS READ-WRITE, READ-ONLY, EXECUTABLE OR CALLABLE 
DATA, WITH ACCESS CONTROLLED BY AN ACL, RING BRACKETS AND AN AIM 
CLASSIFICATION 



ARE SHARED AMONG ADDRESS SPACES, WITH EACH ADDRESS SPACE HAVING 
ITS OWN PERMISSION TO ACCESS THE SEGMENT 
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MULTICS VIRTUAL MEMORY 



CHARACTERISTICS 



B EACH ADDRESS SPACE INTERSECTS IN VARYING DEGREES WITH EVERY OTHER 
ADDRESS SPACE 



B EACH ADDRESS SPACE IS MAPPED DIRECTLY ONTO ITS OWN PAGED, SEGMENTED 
. VIRTUAL MEMORY OF THE SAME SIZE 



B EACH VIRTUAL MEMORY IS MAPPED BY A PAGING ALGORITHM ONTO THE 
SINGLE, SMALLER REAL MEMORY 



E NO LOADING IS REQUIRED SINCE ALL ADDRESSES ARE INTERPRETED AS 
OFFSETS WITHIN SEGMENTS 



B NO LINKAGE EDITING IS REQUIRED SINCE ALL SYMBOLIC REFERENCES ARE 
RESOLVED AT RUN TIME IF AND WHEN THEY ARE ENCOUNTERED (DYNAMIC 
LINKING) 
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MULTICS VIRTUAL MEMORY 



SOLVED PROBLEMS 



8 DATA WITHIN THE ADDRESS SPACE PROTECTED 



B READ OR READ-EXECUTE DATA STORED IN SEPARATE SEGMENTS WHICH ARE 
PROTECTED FROM MODIFICATION 



0 PROGRAMMING ERRORS REFERENCING OUTSIDE ARRAY BOUNDS CANNOT 
REFERENCE DATA IN ANOTHER SEGMENT 



s DATA CAN BE SHARED IN A GENERAL WAY BETWEEN ADDRESS SPACES 



U EACH SEGMENT (NOT A COPY OF THE SEGMENT) CAN APPEAR IN SEVERAL 
ADDRESS SPACES 



fl DIFFERENT PROCESSES CAN HAVE DIFFERENT ACCESS TO THE SAME 
SEGMENT IN THEIR ADDRESS SPACE 



» OVERHEAD AND INCONVENIENCE OF LOADING (SOFTWARE) REPLACED BY AN 
ADDRESS FORMATION SCHEME (HARDWARE) 



S UNREFERENCED PROGRAMS (AND/OR PAGES OF PROGRAMS) DO NOT REQUIRE 
MAIN MEMORY SPACE 
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MULTICS VIRTUAL MEMORY 



SOLVED PROBLEMS 



8 PROGRAMS NEVER REQUIRE PREPARATORY ADDRESS MODIFICATION 



EXPLICIT I/O IS NOT REQUIRED TO ACCESS FILES (SEGMENTS) 



S SEGMENTS CAN BE ACCESSED BY MAKING THEM KNOWN TO THE ADDRESS 
, SPACE AND REFERENCING THE SEGMENT 



THIS IS CALLED VIRTUAL FILE I/O 



OVERHEAD AND INCONVENIENCE OF LINKAGE EDITING REPLACED BY DYNAMIC 
LINKING 



D UNREFERENCED PROGRAMS DO NOT REQUIRE LINKING 



ADVANTAGES OF VERY LARGE ADDRESS SPACE , SHARED FILES, DATA 
PROTECTION, AND VIRTUAL I/O DEFINITELY OUTWEIGH THE COSTS OF PAGING 
AND SEGMENTATION OVERHEAD 
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F80A 



MULTICS VIRTUAL MEMORY 



PROBLEMS 



B MULTICS FILE I/O IS OFTEN LESS EFFICIENT THEN SPECIAL CASED METHODS 
BASED ON KNOWN ACCESS PATTERNS 



8 THE SYSTEM'S SEGMENT SIZE DOES NOT GENERALIZE UPWARD TO HANDLE VERY 
LARfcE DATA BASES. ALTERNATE (KLUDGY) METHODS MUST BE USED (SUCH AS 
MSF'S) 



a THE OVERHEAD TO TOUCH A PAGE OF ONE HUNDRED DIFFERENT SEGMENTS IS 
CONSIDERABLY MORE THAN THE OVERHEAD TO TOUCH ONE HUNDRED PAGES OF • 
THE SAME SEGMENT. (IE: SPARSE AND INFREQUENT ACCESSING IS 
EXPENSIVE) 



8 LACK OF EXPLICIT I/O CONTROL MAKES OVERALL SYSTEM RELIABILITY 
SUFFER SINCE FULL RECOVERY FROM A SYSTEM CRASH REQUIRES THE 
SUCCESSFUL FLUSHING OF ALL PAGES FROM MAIN MEMORY 



| hcs_$force_write MAY BE USED BY THOSE APPLICATIONS REQUIRING 
SUCH RELIABILITY 
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addtype. incl .pi 1 , a1m_temp1ate. Incl .pi 1 , apte . incl .pi 1 , aste. Incl .pi 1 . bos_dump. incl .pi 1 , cmp. incl .pi 1 , dbm. 1ncl .pi 1 , 
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APPENDIX A 
Hardcore Include Files 



add_type. incl .pi 1 •• 1 

aim_temp1ate. incl .pi 1 2 

apte. Incl .pi 1 3 

aste. incl .pi 1 6 

bos_dump. 1ncl .pi 1 8 

cmp. incl .pi 1 11 

dbm. 1ncl .pi 1 12 

dir_acl . Incl .pi 1 13 

dir_al location__area. incl .pi 1 . . 14 

di reentry . incl .pi 1 ........ 15 

dlr header, incl .pi 1 17 

d1r~ht. incl .pi 1 . 19 

d1r_l ink. incl .pl1 20 

di rename, incl .pi 1 . 22 

dirTockt. incl .pi 1 23 

d 1 sk_pack . 1 nc 1 . p 1 1 24 

dskdcl . incl .pi 1 . 26 

ect_structures. incl .pi 1 .... 29 

event_wait_l ist. incl .pi 1 .... 32 

faul t~vector . incl .pi 1 33 

fgbx.Tnd .pi 1 35 

f s_dev_types . incl .pi 1 '36 

fs~types. incl .pi 1 38 

fs~vol label . incl .pi 1 39 

hc'lock. incl .pi 1 41 

itt entry . incl .pi 1 42 

kstTincl.pH 43 

"lock array . inci .pi 1 44 

lvt.Tncl.pl1 45 

mc . i nc 1 . p 1 1 46 

nul 1_addr esses. incl .pi 1 .... 52 

pds.cds 53 

prds . cds 64 

ptw. 1 68. incl .pi 1 72 

pv_ho 1 dt . i nc 1 . p 1 1 73 

pvt . i nc 1 . pi 1 74 

pvte. incl -pi 1 76 

rnt. incl .pi 1 78 

scavenger_data. incl . pi 1 .... 79 

scs. incl .pi 1 81 

sdw. 168. incl .pi 1 85 

sdw_inf o. incl .pi 1 86 

signal 1er_stack. incl .pi 1 .... 87 

slt.incl.pU 88 

site. incl .pi 1 90 

sst . incl .pi 1 92 

sstnt. incl .pi 1 98 

stack_0_data. incl .pi 1 99 

stack_f rame. incl .pi 1 100 

stack_header . incl . pi 1 102 

stock_seg. i ncl . pi 1 104 

str . incl .pi 1 107 

tc_data.cds 108 

tcm. incl . pi 1 • 117 



vol_map. incl .pi 1 123 

vtoc_buf fer . incl .pi 1 ...... 124 

vtoc_header . incl .pi 1 ...... 126 

vtoc_roap . i nc 1 . p 1 1 127 

vtoce. incl .pi 1 128 
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add_type. I net .pi 1 



segment In: > 1 dd> 1 nc 1 ude contents modified: 09/16/77 0925.5 

entry modified: 03/10/82 0836.5 



/+ BEGIN INCLUDE FILE add_type . 1 nc 1 . p 1 1 ♦/ 
/* 02/26/75 by Bernard S. Greenberg */ 

/* This file provides a structure for checking 

PTW/CME address type fields In PL/I */ 

del 1 add_type unaligned static Internal, 
2 core bit (4) Inlt (" 1000"b), 
2 disk bit (4) Inlt ("0100"b), 
2 pd bit (4) Inlt ("0010 ,, b), 
2 reserved bit (4) Inlt ( H 0001"b), 
2 non_nu1! bit (4) Inlt ("111 1"b); 

del 1 badd_type unal Igned based, 

2 (core, disk, pd, reserved) bit (1) unaligned; 

/* END INCLUDE FILE add_type. Incl .pi 1 +/ 



/♦ In core- S/B only In PTW */ 

/* Disk address */ 

/* Paging Device */ 

/* Reserved */ 

/* Not null address ♦/ 



Includf <■ . hard. source 
F80A ot to be reproduced 



add type. Inc 1 . r 



ie 1 



a lm_templ ate . incl .pi 1 



segment In: > 1 dd> » mc I ude contents modified: 12/20/78 1614.1 

entry modified: 03/10/82 0836.6 



/* BEGIN INCLUDE FILE a1m_template. Incl .pi 1 ♦ / 
/* Created 740723 by PG */ 

/* Modified 06/28/78 by C. D. Tavares to add rep privilege */ 

/* This structure defines the components of both an access 
class and an access authorization as interpreted by the 
Access Isolation Mechanism. */ 



del 1 aim_tempiate aligned based. 
2 categories bit (36), 
2 level fixed bin ( 17) unaligned, 
2 privileges unaligned, 
(3 ipc, 

3 dir. 

3 seg, 

3 soos, 

3 rlngl , 

3 rep) bit (1), 

3 pad bit ( 12); 



/* authorization/access class template */ 
/* access categories */ 
/* sensitivity level ♦/ 

/* special access privileges (in authorization only) */ 
/* Interprocess communication privilege +/ 
/* directory privilege */ 
/* segment privilege */ 

/♦ security out-of -service privilege ♦/ 

/* ring 1 access privilege */ 

/* RCP resource access privilege */ 



/* END INCLUOE FILE a lm_templ ate . 1 ncl . ptl */ 



Include.**, hard. source 
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a lm_template. Incl .pi 1 



Page 2 



apte. incl .pi 1 



/* BEGIN INCLUDE FILE ... apte. Incl .pi 1 



del aptep pointer; 

del 1 apte based (aptep) al Igned, 
2 thread unaligned, 

3 fp bit ( 18) . 

3 bp bit ( 18) . 
2 flags unaligned, 

3 mbz bit ( 1 ) , 

3 wakeup_wa1 ting bit (1), 

3 stop_pend1ng bit (1), 

3 pre_empted bit (1), 

3 hproc bit ( 1 ) , 

3 loaded bit (1), 

3 el Iglble bit ( 1 ) . 

3 Idle bit ( 1 ) , 

3 Interact ion bit ( 1 ) , 

3 preempt pending bit (1), 

3 def aul t_procs required bit (1), 

3 realt1me_burst bit (1), 

3 a 1 way s_ loaded bit (1), 

3 dbrloaded bit (1), 

3 being_loaded bit (1), 

3 shared_stack_0 bit (1), 

3 page_wait_f lag bit (1), 

3 f Irstsw bit ( 1 ) , 

3 state bit ( 18), 
2 page faults fixed bin (35), 
2 processld bit (36), 

2 te fixed bin (35), 

2 ts fixed bin (35). 

2 t 1 fixed bin (35). 

2 tlmax fixed bin (35). 

2 1pc_po1nters unaligned. 

3 event_thread bit (18), 

3 pad3 bit ( 18) , 
2 Ipsmessage bit (36), 
2 asteps unaligned, 

3 pds bit (18), 

3 dseg bit ( 18) . 

3 pt ds bit ( 18) . 
2 savex7 bit (18) unaligned. 
2 term_ process Id bit (36), 



include > . hard. source 
"OA ot to be reproduced 



in: >1dd>1nc1ude contents modified: 12/15/82 1432.3 

led: 12/15/82 1433.5 



/♦ 'APT entry declaration for an active (known) process +/ 

/* List thread ♦/ 

/+ Forward pointer */ 

/* Backward pointer */ 

/* Flags and miscellaneous ♦/ 

/♦ This bit must be zero (sentinel bit) +/ 

/* ON if process has received wakeup */ 

/♦ ON If process has received stop connect */ 

/+ ON if process Is being pre-empted by get_processor +/ 

/* ON If process Is hardcore process +/ 

/* ON If required per-process pages are In memory and wired */ 

/* ON If process Is eligible +/ 

/* ON if this Is an Idle process */ 

/* ON If process has Interacted recently */ 

/♦ ON If process has received pre-empt connect +/ 

/* ON If apte. procs_requ1 red is system default */ 

/* ON if next eligibility Is realtime ♦/ 

/* ON If process Is not to be unloaded +/ 

/* ON If DBR is loaded on some CPU */ 

/* ON if somebody loading this process */ 

/* ON If a shared stack_0 Is assigned +/ 

/♦ flag ON if waiting for page +/ 

/+ OFF until process Is Intlallzed +/ 

/+ execution state */ 

/* total page faults for the process +/ 

/♦ bit 0-17: offset of ATPE */ 

/♦ bit 18-35: sequential number ♦/ 

/* virtual time since eligibility award ♦/ 

/+ virtual time since scheduling ♦/ 

/♦ virtual time since Interaction ♦/ 

/♦ maximum value allowed for apte.tl */ 



/♦ relative pointer to ITT list ♦/ 

/♦ IPS signals pending ♦/ 

/* relative ASTE pointers ♦/ 

/+ PDS (per-process) ♦/ 

/♦ DSEG (per-process) ♦/ 

/♦ PROS (per-processor ) ♦/ 

/* x7 at call to getwork (return point In pxss) */ 

/♦ process to send wakeup at temlnatlon */ 



-te 3 



2 lockid bit (36) , /* File System unqleu ID associated with process */ 

2 t ime_used_dock fixed bin (71), /* Total CPU time when process last lost CPU +/ 



2 waitevent bit (36) aligned. 
2 wet index bit (18) unaligned. 
2 f1ags2 unaligned, 

3 pr lorityschedul ing bit (1), 

3 specialwakeups bit (6), 

3 pad7 bit (7), 

3 batch bit (1), 

3 pr_tag bit (3), 
2 state_change_t Ime fixed bin (71), 
2 alarmevent fixed bin (71), 
2 alarm_t1me_thread bit (18) unaligned, 
2 alar m_time~bit (54) unaligned. 



/* Event ID process awaiting */ 
/♦ rel offset of WCTE ♦/ 

/* ON if guaranteed eligibility +/ 
/* Special wakeup channels */ 

/* ON if absentee */ 

/* CPU tag running or last run */ 

/* Time apte.si;ate last changed */ 

/♦ wakeup even<t for alarm clock manager */ 

/♦ thread of processes with pending alarms +/ 

/♦ wakeup time for alarm ♦/ 



2 termchannel fixed bin (71), 

2 wss t ze fixed bin, 

2 temax fixed bin (35), 

2 deadline fixed bin (71), 

2 lock bit (18) unaligned. 

2 unusable bit (18) unaligned, 

2 cpu moni tor fixed bin (35), 

2 pag i ng_measure fixed bin (71), 
2 accessauthor izat ion bit (72), 
2 dbr fixed bin (71), 

2 virtual _cpu time fixed bin (71), 
2 1ttes_sent fixed bin (18), 
2 ittesgot fixed bin (18). 



/* wakeup event for account overflow */ 
/* working set estimate for the process */ 
/* maximum eligibility slice (vcpu) +/ 
/* time of next run */ 

/+ 0 * > APTE locked, unlocked ■> return point of last unlock */ 
/* locking routines destroy */ 

/* If not 0, s<snd wakeup to term_process id when virtual cpu 

/* reaches this (units ■ 1/1024 sec) */ 

/* cumulative memory units */ 

/* authorization of this process */ 

/* DBR value (constant since DSEG entry-held) */ 

/* cumulative virtual CPU time for the process */ 

/* Unprocessed ITTs sent by this process */ 

/* Unprocessed ITTs received by this process */ 



Cells used to drive and Instrument finite-state model for response time 
measurement. Maintained by meter_response_t ime +/ 



2 current_response_state fixed bin (17) unaligned, 

2 pad 18 bit (18) unaligned, 

2 numberprocess 1 ng fixed bin (35). 

2 last_response_state_t ime fixed bin (71). 

2 total _processing_t ime fixed bin (71), 

2 beg 1n_ interact ion_vcpu fixed bin (71). 
/* End of cells for finite-state model ♦/ 



/* Process state in modle */ 
/* Number Interactions */ 

/* Clock time at last response state change */ 
/♦ Total interaction processing time */ 



/♦ Virtual cpu at beginning of last interaction */ 



2 savedtemax fixed bin (35), 

2 procs_requ 1 red bit (8) unaligned, 

2 apad (12) fixed bin (35); 



/* temax at eligibility award ♦/ 

/* bit mask of CPUs this process can run ♦/ 
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/* END INCLUDE FILE ... apte.incl.pll */ 



Includr -, hard. source apte. Incl .pi 1 

FRQA »t to be reproduced 



aste.4ncl.pJ1 0 segment In: >ldd> include contents modified: 1 1/16/82 1454.6 

entry modified: 1 t/ 116/82 1456.6 



/* BEGIN INCLUDE FILE . . . aste. Inc I . pi 1 ... ♦/ 

/* Template for an AST entry. Length ■ 12 words. ♦/ 

/* Words 0 to 7, and 11 are read by PC; they are read and modified by SC. 

Words 8„ 9 and 10 are modified by PC; they should never be modified without locking the PC lock */ 

del astep ptr; 

del 1 aste based (astep) aligned. 



(2 fp bit ( 18) , 


/* 


forward used 1 1st rel pointer */ 




OP Dl I % ? o J , 




backward used list rel pointer */ 


JL 




/ 


ptr to NEXT In list of ASTE's of my brothers */ 




l n f n Kit f <B) 

inrp ui i k 


/ 


ptr to FIIIST in list of ASTE's of my children */ 


2 


c i rn Hit- 1 ifl \ 
air u u ! 3. \ t o } 9 


/* 


rel po lnt*3r to process trailer*/ 


2 




/♦ 


rel pointor to parent aste */ 


2 


u i d b i t ( 36 ) , 


/♦ 


segment unique Id */ 


2 


msl bit (9) . 


/* 


maximum segment length in 1024 word units */ 


2 


pvtx f ixed bin (8) , 


/* 


physical volume table Index ♦/ 


2 


vtocx fixed bin (17), 


/♦ 


vtoc entry Index +/ 


2 


usedf bit ( 1 ) , 


/* 


ast entry Is being used if non-zero */ 


2 


in! t bit ( 1 ) , 


/♦ 


used bit - insure i lap */ 


2 


gtus bit ( 1 ) , 


/♦ 


global transparent usage switch */ 


2 


gtms bit ( 1 ) . 


/* 


global transparent modified switch + / 


2 


he bit ( 1 ) , 


/* 


hard core segment */ 


2 


hesdw bit ( 1 ) , 


/* 


aste with sdw for hardcore seg if non-zero +/ 


2 


any_access_on bit (1), 


/♦ 


any sdw allows access, unless wr i teaccesson */ 


2 


wr 1 te_access_on bit (1). 


/* 


any sdw allows write access */ 


2 


inn lb! t cache bit ( 1 ) . 


/* 


flag not to reset above bits */ 


2 


expl let t deact ok bit (1), 


/♦ 


set if user can deactivate seg ♦/ 


2 


deacterror bit (1). 


/♦ 


set If error occurred while deactivating */ 


2 


hepart bit ( 1 ) , 


/♦ 


set if pages are in a hardcore partition */ 


2 


f m damaged bit ( 1 ) , 


/• 


set If filemap checksum was ever bad */ 


2 


padl bit (3), 


/♦ 


00000 ♦ / 


2 


dius bit ( 1 )„ 


/* 


dumper in use switch */ 


2 


nid bi t ( 1 ) , 


/♦ 


if on prevents addtion to incremental dump map */ 


2 


dmpr pad bit ( 1 ) . 






2 


ehs bit ( 1 ) , 


/* 


entry hold switch */ 


2 


nqsw bit ( 1 ), 


/* 


no quota switch - no checking for pages of this seg +/ 


2 


dirsw bit ( 1 ) , 


/♦ 


directory switch +/ 


2 


master_dir bit ( 1 ) . 


/* 


master dlr - a root for the log volume */ 


2 


vol map seg bit ( 1 ) , 


/♦ 


vol map seg for some volume */ 


2 


tqsw (0:1) bit ( 1 ) , 


/♦ 


terminal quota switch - (0) for non dir pages + / 
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2 pad_ic bit ( 10), 



/ + Used to be aste.lc */ 



2 dtu bit (36), 
2 dtm bit (36). 



2 quota (0:1) fixed bin (18) unsigned. 

2 used (0:1) fixed bin (18) unsigned, 

2 csl bit (9), 

2 fmchanged bit (1), 

2 fms bit (1). 

2 npf s bit (1), 

2 gtpd bit (1), 

2 dnzp bit (1), 

2 per_process bit (1), 

2 ddnp bit (1), 

2 pad2 bit (2), 

2 records bit (9), 

2 np bit (9), 



2 ht_fp bit (18), 

2 fmchanged 1 bit (1), 

2 damaged bit ( 1 ) , 

2 pack_ovf1 bit (1), 

2 synchronized bit (1), 

2 pad3 bit (6), 

2 ptsi bit (2), 

2 marker bit (6)) unaligned; 



del asta (0 : 8000) bit (36*12 /* sst-> sst.astslze */) 



del 1 aste_part aligned based (astep), 

2 one bit (36) unaligned, 

2 two bit (36*11 - 8) unaligned. 

2 three bit (8) unaligned; 



del 1 seg_aste based (astep) aligned, 
2 pad1 bit (8*36), 
2 usage fixed bin (35), 
2 pad2 bit (3*36); 

/* END INCLUDE FILE ... aste. incl .pi 1 */ 



/* date and time segment last used */ 

/* date and time segment last modified */ 



/* sec storage quota - (0) for non dlr pages */ 

/♦ sec storage used - (O) for non dlr pages */ 

/* current segment length In 1024 words units */ 
/* turned on by page If file map changed */ 
/* file modified switch +/ 
/* no page fault switch +/ 

/* global transparent paging device switch */ 
/* don't null out If zero page switch */ 
/* use master quota for this entry */ 
/* don't deposit nulled pages */ 

/* number of records used by the seg 1n sec storage +/ 
/* number of pages In core */ 



/* hash table forward rel pointer +/ 

/* value of "fmchanged" saved by pc$get_f 1 le_map +/ 

/* PC declared segment unusable */ 

/* page fault on seg would cause pack overflow */ 

/* Data Management synchronized segment +/ 

/♦ 000000000 */ 

/♦ page table size Index +/ 

/* marker to Indicate last word of ASTE */ 



based al igned; 



/* fp and bp ♦/ 

/* part that has to be zeroed when ASTE is freed */ 
/* ptsi and marker +/ 



/* Overlay because quota Is only for dlrs */ 
/♦ page fault count: overlays quota */ 



1 nc 1 ude * , hard . source 
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bosdump . incl .pi 1 



segment In: > 1 dd> I nc 1 ude contents modified: 09/08/81 1426.4 

entry modified: 03/1G/82 OB37.0 



/♦ BEGIN INCLUDE FILE ... bosdump. Incl .pi 1 ... ♦/ 
/* Modified 1 September 1976 */ 

/♦ Modified 11/11/80 by d. A. Bush for the DPS8/70M CPU */ 

/* Modified 6/12/81 by Rich Coppola to extend the dps8 extended fault reg to 
15 bits ♦/ 

/♦ Modified 02/23/81. W. 01 In Sibert, to describe old and new FDUMP styles; */ 



del dumpptr ptr; 

del 1 dump based (dumpptr) aligned, 

2 dumpheader aligned like dump_header . 

2 segs ( 1008 ) , 

3 segno bit (18) unal , 
3 length bit (18) unal , 

2 amptwregs (0 : 63) bit (36). 

2 amptwptrs (0 : 63) bit (36). 

2 amsdwregs (O : 63) bit (72), 

2 amsdwptrs (0 : 63) bit (36), 

2 ouhist (0 : 63) bit (72). 

2 cuhist (0 : 63) bit (72). 

2 duhist (0 : 63) bit (72). 

2 auhist (0 : 63) bit (72). 

2 prs (0 : 7) ptr. 

2 regs aligned like dump_registers. 

2 low order_port bit (3). 

2 pad4 bit (36). 

2 met i me fixed bin (52), 

2 pad5 (0 : 3) bit (36). 

2 misc_registers like dump_m 1 sc_reg1sters , 

2 ptr 1 en (0 : 7) bit (36). 

2 coreb locks (0 : 7), 

3 num_f irst bit (18) unal. 

3 numb locks bit (18) unal. 
2 pad? (112) f ixed bin; 



/♦ pointer to following structure ♦/ 
/* header of dump by fdump */ 



/* segment array •/ 
/♦ segment number */ 

/♦ length of segment in sector sized blocks */ 

/* assoc. mem. page table word regs */ 

/* assoc. mem. page table word pointers */ 

/♦ assoc. mem. segment descriptor word registers */ 

/* assoc. mem. segment descriptor word pointers */ 

/♦ operations unit history registers +/ 
/* control unit history registers */ 
/* decimal unit history registers ♦/ 
/♦ appending unit history registers ♦/ 

/* pointer registers +/ 

/* assorted machine registers ♦/ 

/* from which clock is read +/ 

/* time conditions were taken +/ 



/* Assorted registers & processor data +/ 
/♦ pointers and lengths for EIS ♦/ 



/♦ first addr in coreblock +/ 
/* number of blocks used ♦/ 



del 1 dump_header aligned based, /+ Standard header for FDUMP */ 

2 wordsdumped fixed bin (35), /♦ total words in dump +/ 

2 valid bit (1). /* = 1 If there Is a 6100 dump to be had ♦ / 
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2 time fixed bin (71). 
2 erfno f Ixed bin ( 18) . 
2 num segs fixed bin, 
2 val7d_355 bit (1). 
2 dumped_355s bit (4), 
2 t1me_355 fixed bin (71). 
2 version fixed bin, 
2 padO (5) fixed bin; 

del 1 dump_registers aligned based, 
(2 x (0 : 7) bit ( 18). 
2 a bit (36). 
2 q bit (36), 
2 e bit (8), 
2 pad2 bit (28), 
2 t bit (27), 
2 pad3 bit (6), 
2 ralr bit (3)) unaligned; 

del 1 dump misc registers aligned based, 
2 sou To : 7) bit (36). 
2 mem (0 : 7) bit (72), 
2 dbr bit (72), 
2 intrpts bit (36). 
2 bar bit (36), 
2 modereg bit (36), 
2 cmodereg bit (36), 
2 faultreg bit (36), 
2 ext_f aul t_reg bit (15) unaligned, 
2 pad6 bit (21) unaligned; 



del 1 v1_dump aligned based (dumpptr), 

2 dump_header aligned like dump_header, 

2 segs (688), 

3 segno bit (18) unal , 
3 length bit ( 18) unal , 

2 amsdwregs (0 : 15) bit (72). 
2 amsdwptrs (0 : 15) bit (36). 
2 amptwregs (O : 15) bit (36). 
2 amptwptrs (0 : 15) bit (36). 
2 padl (O : 15) bit (36). 

2 ouhlst (0 : 15) bit (72). 

2 cuhist (0 j 15) bit (72), 

2 auhlst (0 : 15) bit (72), 

2 duhlst (0 : 15) bit (72), 

2 prs (O : 7) ptr. 

2 regs aligned like dump_registers , 



includr * , hard. source 
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/* ttme of dump */ 

/♦ Error Report Form Number */ 

/♦ number of segments dumped */ 

/* * 1 if there Is a dn355 dump to be had */ 

/* indicates which 355s were dumped */ 

/* time of 355 dump +/ 

/♦ currently 2 ♦/ 

/* padO to 16 words +/ 

/* Standard (SREG) arrangement of registers in dump 

/♦ index registers */ 

/* the a register */ 

/* the q register +/ 

/* the e register */ 

/♦ pad */ 

/* timer register +/ 
/* pad */ 

/♦ ring alarm register ♦/ 



/* from store control unit instr. */ 

/* memory controller masks every 64 K */ 

/* descriptor segment base register +/ 

/* Interrupts */ 

/* base address register +/ 

/+ mode register */ 

/* cache mode register */ 

/* fault register */ 

/* DPS8 extended fault register */ 



/* Old version of FDUMP (pre March. 1981) */ 



/* segment array ♦/ 

/+ segment number */ 

/* length of segment in sector sized blocks */ 

/* assoc. mem. segment descriptor word registers +/ 

/* assoc. mem. segment descriptor word pointers +/ 

/♦ assoc. mem. page table word regs */ 

/♦ assoc. mem. page table word pointers */ 



/* operations unit history registers */ 
/* control unit history registers +/ 
/* appending unit history registers */ 
/* decimal unit history registers +/ 

/+ pointer registers */ 

/* assorted machine registers */ 



. 1 nc 1 . r 



2 met i me fixed bin (52). 
2 pacM (O : 5) bit (36). 



/♦ time conditions were taken ♦/ 



2 m t screg i s ters aligned like dump_misc 

2 pad5 bit (36), 

2 pt Men (O : 7) bit ( 36 ) . 

2 pad6 ( 15) bit (36) . 

2 loworderport bit (3). 

2 cor eb locks (O . 7), 

3 num_first bit (18) unal . 
3 numb locks bit (18) unal; 



del DUMPVERSIONJ fixed bin Internal static 
del DUMP_VERSI0N_2 fixed bin internal static 

/* END INCLUDE FILE ... bos_dump. incl .pi 1 ... 



jglsters. /♦ Assorted registers */ 

/* pointers and lengths for EIS +/ 
/♦ from which clock was read ♦/ 

/♦ first addr In coreblock ♦/ 
/* number of blocks used ♦/ 

options (constant) Inlt (1); 
options (constant) Inlt (2); 
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crop . 1 nc 1 .pi 1 



segment In: > 1 dd> I nc 1 ude contents modified: 1i/ 19/82 1602.1 

entry modified: 11/19/82 1604.3 



/* BEGIN INCLUDE FILE cmp.1ncl.p11 --- October 1982 */ 
/* Note: This Include file has an ALM counterpart NOT i 

del cmep ptr; 

del 1 erne based (cmep) aligned. 
2 fp bit (18) unaligned, 
2 bp bit (18) unaligned, 

2 devadd bit (22) unaligned, 

2 pad5 bit (1) unaligned, 

2 synch_he 1 d b 1 t ( 1 ) una 1 1 gned , 

2 to bit (1) unaligned. 

2 pad2 bit (1) unaligned, 

2 er bit (1) unaligned, 

2 removing bit (1) una 1 1 gned, 

2 ab8_w bit (1) unaligned, 

2 absjusable bit (1) unaligned, 

2 notTf y_requested bit (1) unaligned, 

2 pad3 bit (1) unaligned, 

2 phm_hedge bit (1) unaligned, 

2 contr bit (3) unaligned, 

2 ptwp bit (18) unaligned, 

2 astep bit (18) unaligned, 

2 p1n_counter fixed bin (17) unaligned, 

2 synch_page_entryp bit (18) unaligned; 



with elf (for historical reasons). Keep It up to date */ 

/* pointer to core map entry */ 

/♦ Core map entry */ 

/* forward pointer to next entry +/ 

/* backward pointer to previous entry */ 

/* device address of page in the core block +/ 

/* Page of synchronized seg held In memory */ 

/* Input/output Indicator 1=output, 0= Input */ 

/* Indicates error In previous 10 activity ♦/ 

/* core Is being removed by reconfiguration */ 

/* absolute address must not be changed for page ♦/ 

/* page may be assigned with fixed absolute address ♦/ 

/* not If y requested on I/O completion */ 

/* on *> pc$f 1ush_core ought write. +/ 

/* controller 1n which core block Is located +/ 

/* pointer to page table word for the page */ 

/* relative AST entry pointer of page */ 

/* number of times to skip eviction */ 

/* relp to synch .page entry */ 



del 1 cma (0: 1) based aligned like erne; 

del 1 mcme based (cmep) aligned, 
2 pad bit (36) unaligned, 
2 record_no bit (18) unaligned, 
2 add_type bit (4) Unaligned, 
2 flags bit (14) unal , 
2 pad1 bit ( 18) unal ; 



/* END INCLUOE FILE cmp.lncl.pll */ 



/* Core map array +/ 

/* core map entry for extracting DID */ 

/* record number of device */ 
/* see add_type. Incl . pi 1 */ 
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dbni . < nc 1 . p 1 1 



segment In: > 1dd> tnc lude contents modified: 05/20/82 1037.5 

entry modified: 05/20/02 1047.5 



/* BEGIN INCLUDE FILE ... dbm. incl.pl 1 ... Feb 1976 ♦/ 

del dbm_seg$ ext; 
del dbmp ptr ; 

del 1 dbm based (dbmp) aligned, 
2 lockdata. 

3 lock bit (36). 

3 event bit (36), 

3 notify bit (1), 
2 control , 

3 init bit ( 1 ) unal . 

3 padi bit (35) una! . 
2 stats, 

3 sets fixed bin unal, 

3 resets fixed bin unal, 

3 allocs fixed bin unal, 

3 frees fixed bin unal, 
2 pad2 (2) bit (36), 
2 area area (255*1024 -8); 

/♦ END INCLUDE FILE ... dbm.incl.pll ♦/ 
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d I rac 1 . incl .pi t 



segment In: > 1 dd> 1 nc 1 ude contents modified: 02/24/76 1923.4 

entry modified: 03/10/82 0836.4 



/* BEGIN INCLUDE FILE ... dir_ad. Incl .pi 1 ... last modified Nov 1975 for nss */ 

/* Template for an ACL entry. Length ■ 8 words */ 
del aclep ptr; 



del 1 ac1_entry based (aclep) aligned, 

2 frp htt(18) unaligned, 

2 brp b1t(18) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned, 



/+ length is 8 words +/ 

/* rel ptr to next entry */ 

/* rel ptr to previous entry */ 

/* type •= dlr acl */ 
/* size of acl entry */ 



2 name unal 1gned, 

3 pers_rp b1t(18) unaligned, 
3 proJ_rp bit (18) unaligned, 
3 tag char(1) unaligned* 
2 mode bit (3) unaligned, 
2 pad24 bit (24) unaligned. 

2 ex_mode bill: (36), 

2 checksum bit (36), 
2 owner bit (36); 



/* user name associated with this ACL entry */ 

/* name of user */ 

/* project of user */ 

/* tag of user */ 

/* mode for user id */ 



/* extended access modes */ 

/* checksum from acl_entry . name */ 
/* uid of owning entry ♦/ 



/* Template for a person or project name on ,ACL. Length - 14 words. */ 



del 1 access name aligned based, 
2 frp bi T( 18 Jl unaligned, 
2 brp bit(18) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned, 

2 sa1v__f1ag fixed b1n(17) unaligned, 
2 usage fixed b1n(17) unaligned, 

2 pad1 bit (36). 

2 name char (32) aligned, 

2 checksum bit (36), 

2 owner bit (36); 

/* END INCLUDE FILE ... dir_acl . incl .pi 1 */ 



/+ person or project name +/ 

/* rel ptr to next name structure */ 

/* rel ptr to prev name structure */ 

/* type =» access name */ 
/* size of access name */ 

/* used by salvager to check for ascli names */ 

/* number of ACL entries that refer to this name */ 



/* person or project name Itself */ 

/♦ checksum from salv_flag */ 

/* uid of containing directory +/ 
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d i r_a 1 1 oca t 1 on area . * nc 1 . p 1 1 segment In: >1dd>include contents modified: 09/22/76 1439.9 

entry modified: 03/ 10/82 0836.6 



/* BEGIN INCLUDE FILE ... dir_al1ocation_area.incl.pl1 ... last, modi f led December 1973 ♦/ 



del areap ptr; 

del 1 area based (areap) aligned, 

2 nsizes fixed bin (18), 

2 lu f ixed bin ( 18) . 

2 1w fixed bin ( 18). 

2 array (100) aligned, 

3 fptr bit (18) unaligned, 

3 size fixed bin (17) unaligned; 

/♦ END INCLUDE FILE ... dir_al locat ion 



/♦ Number of types. ♦/ 

/* Next available word in area. ♦/ 

/♦ Last usablB word. ♦/ 

/♦ Array of types. ♦/ 

/♦ Free pointer for this size. ♦/ 

/♦ Size. */ 

area . incl . pi 1 ♦/ 



include.**, hard. source dir al locat ion area. Incl .pi 1 Page 14 
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segment In: > 1 dd> 1 nc 1 ude contents modified: 04/26/76 1720.0 

entry modified: 03/10/82 0836.5 



/* 



BEGIN INCLUDE FILE 



d1r_entry . Incl .pi 1 ...last modified August 1974 for nss */ 



/* Template for an entry. Length - 38 words */ 
del ep ptr; 

del 1 entry based (ep) aligned, 

(2 efrp bit ( 18). 

2 ebrp bit ( 18) ). unal Igned, 

2 type bit (18) unaligned, 

2 stze fixed bin (17) unaligned, 

2 uld bit (36), 

2 dtem bit (36), 

(2 bs bit (1), 

2 padO bit (17), 

2 nnames fixed bin (17), 

2 narnef rp bit (18), 
2 name_brp bit (18), 

2 author, 

3 pers_rp bit (18), 
3 proJ_rp bit ( 18), 

3 tag char ( 1 ) , 
3 padl char (3), 

2 prlmary_name bit (504), 

2 dtd bit (36). 

2 pad2 bit (36), 



/* forward rel ptr to next entry */ 

/+ backward rel ptr to previous entry */ 

/* type of object = dlr entry */ 
/* size of dlr entry */ 

/* unique Id of entry */ 

/* date-time entry modified +/ 

/* branch switch = 1 1 f branch */ 

/* number of names for this entry ♦/ 

/* rel pointer to start of name list */ 
/+ rel pointer to end of name list */ 

/* user who created branch */ 

/* name of user who created branch */ 

/+ project of user who created branch */ 

/* tag of user who created branch */ 

/+ first name on name list +/ 
/♦ date time dumped +/ 



/* the declarations below are for branch only */. 



2 pvld bit (36), 

2 vtocx fixed bin (17), 
2 pad3 bit ( 18) , 



/* physical volume 1d */ 
/* vtoc entry Index +/ 



2 dlrsw bit (1), 



/+ = 1 If this Is a directory branch */ 



Include *, hard.source dlr entry . Incl .• ' * r-ie 15 

r * , 0A pt to be reproduced 



2 oosw bit ( 1 ) . 

2 per_process_sw bit (1). 

2 copysw bit ( 1 ) . 

2 saf etysw bit ( 1 ) „ 

2 mui t ipie_class bit (1). 

2 audi t_f lag bit (1). 

2 secur i ty_oosw bit (1), 

2 entryptsw bit ( 1 ) „ 

2 masterdlr bit ( 1 ) , 

2 tpd bit ( 1 ) , 

2 pad4 bit (II), 

2 entryptbound bit (14)) unaligned. 

2 accessclass bit (72) aligned. 

(2 ring_brackets (3) bit (3). 
2 exr ing brackets (3) bit (3). 
2 acle count fixed bin (17). 

2 aclfrp bit ( 18), 
2 aclbrp bit (18), 

2 bc_author, 

3 persrp bit (18). 
3 proj_rp bit ( 18) . 

3 tag char ( 1 ) , 
3 pad5 bit (2). 
2 be fixed bin (24)) unaligned. 

2 sonslvid bit (36). 

2 pad6 bit (36). 

2 checksum bit (36), 

2 owner bit (36); 

/* END INCLUDE FILE ... dir^entry. incl pi 1 ... ♦/ 



/♦ out of service switch on = 1 +/ 

/* indicates segment is per process +/ 

/♦ = 1 make copy of segment whenever Initiated */ 

/* if" 1 then entry cannot be deleted */ 

/♦ segment has multiple security classes */ 

/♦ segment must be audited for security ♦/ 

/* security out of service switch */ 

/♦ 1 if call limiter is to be enabled */ 

/* TRUE for master directory ♦/ 

/* TRUE If this segment is never to go on the PD */ 
/♦ cal 1 I i mi tor ♦/ 

/* security attributes : level and category ♦/ 

/♦ ring brackets on segment ♦/ 
/♦ extended ring brackets ♦/ 
/* number of entries on ACL +/ 

/* rel ptr to start of ACL */ 
/♦ rel ptr to end of ACL */ 

/♦ user who last set the bit count ♦/ 
/* name of user who set the bit count */ 
/♦ project of user who set the bit count */ 

/♦ tag of user who set the bit count */ 

/* bit count for segs, msf indicator for dirs */ 

/♦. logical volume id for tmmediat Inf non dir seg */ 



/♦ checksum from dtd ♦/ 

/* uid of containing directory ♦/ 



include. ♦*, hard. source 
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d 1 r_header . 1 nc 1 . p 1 1 



segment In: > 1 dd> 1 nc I ude contents modified: 05/12/82 1246.4 

entry modified: 05/12/82 1254.5 



/* BEGIN INCLUDE FILE ... d1r_header.1nc1.pU */ 

/* Modified 8/74 for NSS */ 

/* Modified 8/76 to add version number and hash table rel pointer for variable hash table sizes */ 
/* Modified 3/82 BIM for change pclock */ 
/* format: styte3 */ 

/+ Template for the directory header. Length • 64 words. */ 
del dp ptr; 

del 1 dlr based I dp) aligned. 



2 modify bit (36). 
2 type bit (18) unaligned, 
2 size fixed bin (17) unaligned. 
2 dtc (3), 

3 date bit (36), 

3 error bit (36), 

2 uld bit (36). 

2 pvld bit (36), 

2 sonslvld bit (36), 

2 access_c1ass bit (72), 

(2 vtocx fixed bin (17), 

2 vers1on_number fixed bin (17), 



2 seg_count fixed bin (17), 
2 d1r_count fixed bin (17), 

2 Icount fixed bin (17), 

2 ac1e_tota1 fixed bin (17). 

2 arearp bit ( 18 ) , 



/* Process ID of last modifier */ 
/* type of object ■ dlr header */ 

/+ size of header In words */ 

/* date-time checked by salvager array +/ 

/* the date */ 

/* what errors were discovered */ 



/* uld of the directory 

/* phys vol Id of the dlr 

/* log vol Id for Inf non dlr seg 

/* security attributes of dlr 

/+ vtoc entry Index of the dlr 

/* version number of header +/ 



copied from branch +/ 
copied from branch */ 
copied from branch */ 
copied from branch */ 
copied from branch */ 



2 


entryf rp 


bit (18). 


/♦ 


rel 


ptr 


to 


2 


pad2 bit 


(18). 










2 


entrybrp 


bit ( 18) , 


/* 


rel 


ptr 


to 


2 


pad3 bit 


(18). 










2 


per s f rp 


bit (18). 


/♦ 


rel 


ptr 


to 


2 


proJ_f rp 


bit (18). 


/* 


rel 


ptr 


to 


2 


pers_brp 


bit (18), 


/♦ 


rel 


ptr 


to 


2 


pro j brp 


bit (18). 


/♦ 


rel 


ptr 


to 



/* number of non-directory branches */ 
/* number of directory branches */ 

/* number of links */ 

/♦ total number of ACL entries In directory +/ 

/* relative pointer to beginning of allocation area */ 



Include hard. source 
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2 per_procGSS_sw bit 
2 masterdir bit ( 1 ) 
2 forcejpv bit ( 1 ) , 
2 rehashing bit ( 1 ) , 
2 pad4 bit ( 14 ) , 



( 1) 



/* indicates dlr contains per process segments */ 

/♦ TRUE if this is a roaster dir */ 

/♦ TRUE if segs must be on RPV ♦/ 

/+ TRUE if ha»h table is being constructed */ 



2 iaci count (0:7), 
3 seg f ixed bin ( 17 ) . 
3 dir f ixed bin ( 17) . 

2 iacl (0:7). 

3 seg_frp bit ( 18) , 
3 segbrp bit ( 18) . 

3 dir_f rp bit ( 18) . 
3 d1r_brp bit ( 18) . 

2 htsize fixed bin ( 17). 
2 hash_tab1e_rp bit (18). 

2 htused fixed bin (17). 
2 pad6 f ixed bin ( 17) . 

2 tree_depth fixed bin (17), 
2 pad7 bit (18)) unaligned, 

2 dts bit (36) „ 

2 master_dir_uld bit (36), 

2 change_pc1ock fixed bin (35), 

2 pad8 (11) bit (36) . 

2 checksum bit (36), 

2 owner bit (36); 



/♦ number of initial ad entries for segs */ 

/♦ number of initial acl entries for dir */ 

/+ pointer to initial ACLs for each ring */ 

/* rel ptr to start of initial ACL for segs */ 

/♦ rel ptr to end of initial ACL for segs */ 

/♦ rel ptr to start of initial for dlrs */ 

/+ rel ptr to end of initial ACL for dirs ♦/ 

/* size of hash table +/ 

/* rel ptr to start of hash table */ 

/* no. of used places in hash table */ 



/* number of levels from root of this dir «■/ 



/* date-time directory last salvaged +/ 

/* uid of superior master dir */ 

/* up one each call to sum$dirmod */ 

/* pad to make it a 64 word header ♦/ 

/* check summed from uid on */ 

/♦ uid of parent dir */ 



del vers ion_number_2 fixed bin int static options (constant) Init (2); 
/♦ END INCLUDE FILE ... d 1 r_header . Inc 1 . pi 1 ♦/ 



include. ++. hard. source 
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dir_ht. incl .pi i 



segment In: > 1 dd> i nc 1 ude contents modified: 10/19/76 1420.6 

entry modified: 03/10/82 0836.5 



/* BEGIN INCLUDE FILE ... dir_ht.lncl.pl1 */ 



del htp ptr; 

del 1 hash_table based (htp) aligned, 
2 modify bit (36) unal. 
2 type bit (18) unal , 
2 size fixed bin (17) unal, 
2 name_rp (0:1) btt(18) una! , 
2 checksum bit (36) unal. 
2 owner bit (36) unal; 



/* END INCLUDE FILE .... d1r_ht . Incl .pi 1 */ 



/* htp * ptr(dp,active_hardcore_data$htrp) */ 

/+ type ■ dir hash table +/ 

/♦ size Of current dir hash table entry */ 

/* rel ptr of name entry */ 



/*. otherwise rel ptr to name */ 



1 nc 1 ude * , hard . source 
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dirl Ink. tncl.pll 



segment tn: 
entry modified: 



>1dd> include 
O7/30/82 1442.9 



contents modified: 02/24/76 1923.5 



/♦ BEGIN INCLUDE FILE ... dir_1 ink . Incl .pi 1 ... last modified August 1974 for nss ♦/ 

/* Template for link. Note that it is identical to entry for first 24 words. */ 



del 1 link based (ep) aligned, 

(2 ef rp bit ( 18) „ 
2 ebrp bit ( 18), 

2 type bit ( 18), 

2 size f ixed bin ( 17) , 

2 uid bit (36). 

2 dtem bit (36). 

2 bs bit (1), 

2 padO bit (17), 

2 nnames fixed bin (17). 

2 name_frp bit (18), 
2 name_brp bit (18), 

2 author, 

3 pers_rp bit ( 18) , 
3 proj_rp bit ( 18) . 

3 tag char ( 1 ) , 
3 padl char (3). 

2 primaryname bit (504). 

2 dtd bit (36). 

2 pad2 bit (36). 



/* forward rel ptr to next entry */ 

/♦ backward rel ptr to previous entry */ 

/* type ■ dlr 1 ink */ 

/* size of link in words */ 

/♦ unique id of entry */ 

/♦ date- time csntry modified */ 

/♦ entry switch * 1 if entry */ 

/* number of names for this entry */ 

/* rel pointer to start of name list */ 
/* rel pointer to end of name list */ 

/♦ user who created entry */ 

/* .name of user who created entry */ 

/* project of user who created entry */ 

/* tag of user who created entry ♦/ 

/♦ first name on name list ♦/ 
/* date time dumped */ 



/+ the declarations below are only applicable to links ♦/ 
2 pad3 bit ( 18) „ 

2 pathnames ize fixed bin (17). /♦ number of characters In pathname */ 

2 pathname char (168 refer (pathname_s1ze) ) ) unaligned, /* pathname of link +/ 

2 checksum bit (36). /* checksum from uid */ 

2 owner bit (36); / + uid of containing directory */ 



include.**, hard. source 
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/+ END INCLUDE FILE ... dir_nnk.1nc1.p11 +/ 
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d i rname . i nc 1 .pi 1 



segment In: > ldd> Inc lude 

entry modified: 03/ 10/82 OB36.5 



contents modlf ied: 10/19/76 1420.6 



/♦ BEGIN INCLUDE FILE ... d1r_name.1ncl.pl1 ... last modified Nov 1975 for nss ♦/ 

/* Template for names of branches or links. Length = 14 words. */ 
del np ptr; 



del 1 names based aligned, 
2 fp bit (IB) unaligned, 
2 bp bit(18) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned, 

2 entry_rp bit (IB) unaligned, 

2 ht_ index fixed bin(17) unaligned. 

2 hashthread bit (IB) unal . 
2 pad3 bit (18) unal , 

2 name char (32) aligned, 

2 checksum bit (36), 

2 owner bit (36); 



/♦ based on pt r(dp . ep->entry . name_f rp) */ 
/* rel ptr to next name */ 
/* rel ptr to ,prev name ♦/ 

f* type ■ dir name */ 
/* size of dir name */ 

/* rel ptr to entry */ 

/♦ index of hash table entry */ 

/* relative ptr to next hash entry */ 



/* check bum from entry_rp ♦/ 
/♦ uid of entry */ 



/* 



END INCLUDE FILE ... dir_name. incl .pi 1 ♦/ 
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dir lockt . incl .pi 1 



segment In: > 1 dd> 1 nc 1 ude contents modified: 03/09/83 1400.0 

entry mod I fled: 03/09/83 1401.4 



/* BEGIN INCLUDE FILE dlrlockt. Incl .pi 1 

/* Modified BIM 1/83 cleanup to multi-read lock */ 



/* format: sty !e3, 1d1nd25 */ 
del d1r1ockt_seg$ 
del dirlocktp 



ext; 
ptr; 



*/ 



/* name of the segment containing the directory locks +/ 
/+ pointer to the dlrlock table */ 



del . 



1 dlrlockt 



declare 
declare 



lock 
Ind 

not1fy_sw 
last 

h1ghest_1ast 

counter 

dlrlock 



dir__lock__ptr 
1 dTr lock 

2 pTd 

2 Ind 

2 not1fy_sw 
2 salvage sw 
2 padl 

2 lock count 



based (dlrlocktp) aligned, 

/* 



Table of locks for dlrecyories */ 
Lock for the table itself */ 
Event for the above lock */ 



bit (36), /+ 
fixed bin (35), /* 
bit (1), 

fixed bin (17), /* Index of the last entry currently used */ 

fixed bin (17), /* Highest index ever used */ 

(1:59) fixed bin (35), /* count(i) ■ number of times entry 1 was used 
(1:10000) aligned like dir__1ock; 

/* entry for a directory lock */ 

pointer; 

aligned based (d1r__!ock_ ptr ) , 



*/ 



bit (36), 
bit (36) aligned, 
bit ( 1 ) una 1 1 gned , 
bit ( 1 ) unal igned, 
bit (34) unal Igned, 
fixed bin (35); 



/* pld of the process that locked the dir for write */ 

/* uid of the directory - also used as event id */ 

/* ON If one or more processes are waiting for the lock +/ 

/* ON if dir was locked for salvage */ 

/* POSITIVE --> write_1ock */ 

/* NEGATIVE --> -number of lockers */ 

/* ZERO --> not locked */ 



/* END dlrlockt. incl .pi 1 */ 
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d i sk_pack . 1 nc I . p 1 1 



segment ' in: 

entry modified: 



> ldd> include 
O5/20/82 1047 



contents modified: 05/20/82 1037.5 



/* 



BEGIN INCLUDE FILE. . . d i sk_pack . i nc 1 . p 1 1 



Last Modified January 1982 for new volume map */ 



/* 



All disk packs have the standard layout described below: 



Record 
Record 
Record 
Record 
Record 



to 3 
to 5 



Records 8 to n-1 

each record contains 5 

Records n to N- I 



: contains the label, as declared in fs_vo1 label . incl .pi 1 . 
: contains the volume map, as declared in vo1_map. Incl .pi 1 
: contains the dumper bit map, as declared in dumper_b1 t_map. incl .pi 1 
: contains the vtoc map, as declared In vtocjmap. Incl .pi 1 
: formerly contained bad track list; no longer used. 
: contain the array of vtoc entries; ( n Is specified in the label) 
192-word vtoc entries. The last 64 words are unused. 

: contain the pages of the Multics segments. ( N is specified in the label) 



Sundry partitions may exist within the region n to N-1, withdrawn or not as befits the meaning 
of the particular partition. 



A 


conceptual declaration 


for a 


disk pack 


could be: 






del 1 disk_pack. 












2 


label_record 


(0 


0) 


b1t(36 


* 


1024 ) . 


2 


vo 1 ume_map_record 


( 1 


3) 


bit (36 


+ 


1024) , 


2 


dumper_b 1 t_map_record 


(4 


5) 


b1t(36 


* 


1024) , 


2 


v toc_map_record 


(6 


6) 


bit (36 


* 


1024) . 


2 


spare_record 


(7 


7) 


b1t(36 


* 


1024). 


2 


vtoc_array_records 


(8 


n-1). 








3 


vtoc_entry ( 5 ) 






bit(36 


* 


192). 


3 


unused 






bit (36 


♦ 


64) . 


2 


Mul t 1cs_pages_records 


(n 


N-1) 


bit (36 


+ 


1024); 



del 



(LABEL_ADDR 
VOLMAP ADDR 
DUMPER_BIT_MAP_ADDR 
VT0C_MAP_ADDR 
VT0C_0RIGIN 
SECT0RS_PER_VT0CE 
VT0CES_PER_REC0RD 
DEFAULTJICPARTSIZE 
MAX VTOCE PER PACK 



1nit (0). 
Init (1), 
Init (4). 
Init (6), 
init (8). 
Init (3). 
Init (5). 
init*( 1000), 
Init (31774)) 
f Ixed bin ( 17) 



Int 



/♦ 
/* 
/* 
/♦ 
/* 



/* 
/* 

static options 



Address of Volume Label */ 
Address of first Volume Map record */ 
For initial release compa i t Ibl 1 ty */ 
Address of first VTOC Map Record */ 
Address of first record of VTOC */ 



Size of Hardcore Partition */ 
Limited by size of VTOC Map */ 
(constant ) ; 



Include.**, hard. source 
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/* END INCLUDE FILE. . . d 1 sk_pack . 1 nc 1 .pi 1 */ 
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dskdc! . incl .pi 1 



segment in: > 1 dd> i nc 1 ude contents modified: 08/17/82 1421.1 

entry modified: 08/17/82 1426.7 



/* Begin Include file ...... dskdc 1 . Incl .pi 1 ♦/ 

/ + Structures used by the Disk DIM */ 

/* format: style4 .delnl , insnl , tree, 1 f thenstmt , indnont terend */ 

del dtsk_seg$ ext; /♦ disk data segment */ 

del disksp ptr, /♦ pointer to disk subsystem info */ 

diskp ptr; /♦ pointer to disk DIM info structure +/ 



del 1 dlskdata based (disksp) aligned, 
2 subsystems fixed bin. 
2 freeof fset bit ( 18) . 
2 status_mask bit (36). 
2 1 as t_queue_t f me fixed bin (71). 
2 pad (2) fixed bin. 
2 array (32). 
( 

3 offset bit ( 18). 
3 pad bit ( 18) , 
3 name char ( 4 ) 
) una); 

del 1 disktab based (diskp) aligned. 
2 lock bit (36) una! , 
2 nchan f ixed bin, 
2 ndrives fixed bin, 
2 channels_onl Ine fixed bin, 
2 dev_busy bit (64). 
2 devqueued bit (64), 
2 wq (0: 1) 1 Ike qht , 
2 free_q like qht, 

2 absmemaddr fixed bin (26) unsigned, 

2 pad f ixed bin, 

2 errors fixed bin, 

2 ferrors fixed bin, 

2 edac_errors fixed bin, 

2 pgjo count (0:1) f fxed bin, 

2 vtlocount (0:1) fixed bin, 

2 cal l_lock_meters like di sk_lock_meters , 

2 i n t_l ock meters like disk_lock_meters. 

2 a 1 1 oc_wa 1 t meters like di sk_l ock_meters , 

2 run_lock_meters like disk lockjueters, 

2 pg_wait (0:1) fixed bin (52), 

2 vt_wa1t (0:1) fixed bin (52). 

2 pg_lo (0:1) fixed bin (52). 

2 vt_io (0: 1) fixed bin (52), 

2 queue (64) like quentry, 

2 chantab (8) like chantab, 



/+ disk subsystem information */ 

/♦ number of subsystems ♦/ 

/* offset of first unused location in segment */ 

/* mask for checking for disk error */ 

/* for dump analysis, to interpret 0 times */ 

/* per subsystem info +/ 

/* location of data for this subsystem */ 



/* name of subsystem */ 

/♦ control structure for DIM's */ 

/* data base lock +/ 

/* number of disk channels */ 

/* highest disk drive number */ 

/♦ number of d1 sk- channel s actually in use */ 

/* busy bit for each device */ 

/* requests queued bit for each device */ 

/+ wait queue head/ tail */ 

/♦ free queue head/ tail */ 

/* absolute memory address of this structure */ 

/* error count */ 

/* fatal error count */ 

/* count of EDAC correctable errors +/ 

/* count of page I/O operations */ 

/* count of VTOCE I/O operations */ 

/* lock meters for call side of DIM + / 

/* lock meters for Interrupt side of DIM +/ 

/* meters for queue entry allocations */ 

/* lock meters for run calls +/ 

/+ total time spent waiting for page I/O */ 

/+ total time spent waiting for VTOCE I/O */ 

/* total time spent doing page I/O */ 

/+ total time spent doing VTOCE I/O */ 

/* queue entries */ 

/* channel Information table ♦/ 



include.**, hard. source 
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2 devtab (O refer ( disk tab. ndr 1 ves ) ) 

%page; 

del qp ptr, 
cp ptr; 

del 1 quentry based (qp) aligned, 
( 

2 next bit ( 18), 

2 wrlte^sw bit (i), * 

2 sect sw bit ( 1 ), 

2 testing bit ( 1). 

2 retry bit (1), 

2 used bit (1), 

2 swap bit (1). 

2 cyl inder fixed bin (11), 

2 pdi unsigned fixed bin (6), 

2 coreadd bit (24), 

2 dev unsigned fixed bin (6), 

2 sector bit (21). 

2 pad bit (9). 

2 n_sectors fixed bin (6) unsigned, 
2 time fixed bin (36) unsigned 
) una 1 ; 

del 1 chantab based (cp) aligned, 
2 chx fixed bin (35), 
2 1o1_ctx fixed bin (35), 
2 statusp ptr, 
2 chan id char (8), 
( 

2 padO bit (18), 

2 in_use bit (1), 

2 active bit (1). 

2 rsr bit (1), 

2 prior bit (1), 

2 1oi_use bit ( 1 ). 

2 inop bit (1), 

2 broken bit (1), 

2 action code bit (2), 

2 padl bit (9) 

) unal , 

( 

2 qrp bit (18). 
2 pad2 bit (3). 
2 command bit ( 6 ) , 
2 erct fixed bin (8) 
) una 1 , 

2 select data, 
( 

3 limit bit (12). 

3 mbz bit (3), 

3 sector bit (21) 

) unaligned, 
2 connect_t1me fixed bin C52), 
2 connects fixed bin. 



Include + , hard. source 
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/* device Information table */ 

/* pointer to queue entry */ 

/* pointer to channel Information table */ 

/* queue entry */ 

/* index to next queue entry */ 

/* non-zero for write operation */ 

/* non-zero for single sector operation */ 

/* non-zero If quentry Is for disk ready test */ 

/* non-zero If retry has been performed on broken device */ 

/+ non-zero if queue entry In use */ 

/* disk cylinder number */ 
/* pdi of device */ 

/* memory address for data transfer */ 
/* disk device code */ 
/* disk sector address */ 

/+ number of sectors for sector I/O */ 

/* low-order microsecond clock at queue */ 

/* time entry was queued */ 

/* channel Information table */ 

/* io_manager channel index */ 

/* loi channel table index */ 

/* pointer to hardware status word */ 

/+ channel name +/ 



/* non-zero if channel being used */ 

/* non-zero if channel active */ 

/* non-zero If RSR in progress */ 

/* priority of current request */ 

/* non-zero If channel usurped by 101 +/ 

/* non-zero if channel inoperative +/ 

/* non-zero if channel broken */ 

/* saved from status +/ 



/* rel ptr to queue entry */ 

/* peripheral command */ 

/* error retry count */ 

/* data passed to IOM on select */ 

/* limit on number of sectors */ 



/* sector address */ 

/* time of last connect */ 

/* count of connects performed */ 
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2 detal 1ed_status (O: 17) bit (8) unal, 

2 rstdcw bit (36), 

2 scdcw bit (36), 

2 sddcw bit (36), 

2 dcdcw bit (36). 

2 dddcw bit (36), 

2 dscdcw bit (36), 

2 dsddcw bit (36), 

2 rssdcw bit (36). 

2 status bit (36) aligned; 

'/.page ; 

del 1 qht al igned based, 

2 (head, tall) bit (18) unal; 

del dp ptr, 

pvtdip ptr; 

del 1 devtab based (dp) aligned, 
( 

2 pvtx fixed bin (8). 

2 1 nop bit ( 1 ) . 

2 wasbroken bit (1). 

2 broken bit ( 1 ) , * 

2 abandoned bit ( 1 ) , 

2 pad bit (11), 

2 buddy unsigned fixed bin (6), 
2 pdi unsigned fixed bin (6) 
) una 1 , 

2 queue_count fixed bin (8), 

2 cylinder fixed bin (11). 

2 seek distance fixed bin (35, 18), 

2 read_count fixed bin, 

2 write_count fixed bin, 

2 timeinop fixed bin (52); 

del 1 pvtdl based (pvtdip) aligned. 
( 

2 sx fixed bin (11). 

2 usablesectpercyl fixed bin (11), 
2 unused_sect_per_cy 1 fixed bi'n (11) 
) unal ; 

del 1 disk_lock_meters based aligned, 
2 count fixed bin. 
2 waits fixed bin, 
2 waittime fixed bin (52); 

del ( 

RST_LISTX Inlt (1), 
SC_LISTX Init (2). 
DSC_LISTX Inlt (6). 
RSS_LISTX init (8) 

) fixed bin (12) static options (constant); 
/* End of include file ...... dskdc 1 . incl . pi 1 */ 



include.**, hard. source 
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/* detailed status bytes */ 

/* restore command ♦ / 

/* select command */ 

/* select data xfer */ 

/* command to read or write ♦/ 

/♦ data xfer DCW */ 

/♦ RSR command */ 

/♦ RSR data xfer ♦/ 

/* RSS command */ 

/* saved status ♦/ 

/* queue head/tail structure */ 



/* pointer to device information table */ 
/* pointer to diminfo in PVT entry */ 

/♦ device information table */ 

/* index of PVT entry for device */ 

/* device inoperative */ 

/♦ device previously broken */ 

/♦ device down »/ 

/* device lost and gone forever */ 

/* other device on this spindle or 0 */ 

/* primary device Index */ 

/* count of requests queued for device */ 

/* current cylinder position +/ 

/* average seek distance */ 

/* count of reads */ 

/* count of writes */ 

/* time drive became inoperative */ 

/* disk DIM Info. In PVT entry */ 

/* structure Index */ 

/* tf of usable sectors on disk cylinder */ 

/* tt of unused sectors at end of cylinder */ 

/* lock meters for disk DIM .*/ 

/* total number of attempts */ 

/+ number of attempts which required waiting */ 

/* total time Eipent waiting */ 



/* 1 istx for restore */ 
/* listx for select */ 
/* 1 istx for RSR */ 

/* I istx for RSS ♦/ 
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ect_structures . Incl .pi 1 



segment in: > 1 dd> 1 nc 1 ude contents modified: 09/30/81 1358.8 

entry modified: 03/10/82 0837.0 



/* 



BEGIN INCLUDE FILE 



ect_structures. Incl .pi 1 



dan 1981 */ 



/* format: styles */ 



del 
del 

del 



del 
del 
del 
del 

del 
del 



ectptr 
ectep 



ptr; 
ptr ; 



1 ect_header 
2 ect_areap 
2 ect_area_size 
2 flags, 

3 cal 1_pr1ority bit (1) unal, 



aligned based (ect_ptr), 
ptr , 

fixed bin ( 19) , 



3 unused bit (17) unal, 

3 mask cal 1_count 

fixed bin ( 17) unal , 
2 count (0:5) fixed bin. 



2 enltry_1 1st_ptrs (4), 



3 flrstp ptr, 

3 lastp ptr, 
2 meters, 

3 total _wakeups fixed bin (33), 

3 total wait wakeups 

fixed bin (33), 

3 total_ca1 1_wakeups 

fixed bin (33), 
2 seed fixed bin (33), 

2 Ittes tossed fixed bin (33), 



2 fill 

TOTAL 
WAIT 
CALL 
EV CALL 



(5) fixed bin; 



/* points to base of Event Channel Table header */ 
/+ points to event channel table entry +/ 

/+ structure of the Event Channel Table header */ 

/* pointer to area tn which ect entries are allocated +/ 

/* number of words In ect area */ 

/* ■ "0"b If wait chns have priority - default +/ 
/* » "1 M b If call chans have priority */ 



/* number times event call chans masked */ 
/* totals of entries allocated */ 

0 ■ number of entries. 1 ■ number of wait channels +/ 

2 ■ number of call channels */ 

3 ■ number of call channel messages */ 

4 ■ number of itt messages, 5 ■ number of messages */ 
/* head and tail of lists in ECT */ 

/* 1 ■ wait channels, 2 = call channels */ 

/* 3 ■ call channel messages, 4 » itt messages */ 

/* head of list */ 

/* tail of list */ 



/* 
/* 
/* 
/* 



/* total wakeups sent on all channels */ 

./* wakeups sent on wait channels */ 

/* wakeups sent on call channels */ 
/* used to generate uid portion of channel name */ 
/* number Invalid ITT messages received. Ignored */ 
/* pad to 36 words */ 



MESSAGE 



ITT MESSAGE 
EV MESSAGE 



fixed bin static options (constant) init (0); 

fixed bin static options (constant) init (1); 

fixed bin static options (constant) init (2); 

fixed bin static options (constant) Init (3); 

/* used to Index count and entry_l ist_ptrs arrays */ 

fixed bin static options (constant) Init (4); 

fixed bin static options (constant) init (5): 



del 



wa 1 t__channe1 
2 word_0, 

3 unused 1 

3 type 
2 next_chanp 



aligned based (ectep) 

fixed bin ( 17) unal . 
fixed bin ( 17) unal . 
ptr unal , 



/* Event wait channel - type ■ WAIT +/ 



/* - WAIT */ 

/* pointer to next wait channel */ 
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del 



del 



del 



2 prev_chanp ptr unal , /* pointer to previous wait channel */ 

2 word 3 , 

3 unused2 bit (1) unal, 

3 inhtbi tcount fixed bin (16) unal , /* number of tinfes message reception has been inhibited */ 

3 wakeupcount fixed bin (18) unal unsigned. /+ number of wakeups received over this channel */ 



name 

f i rst_ev_msgp 
1 ast_ev_msgp 
unused3 



f 1 xed bin 
f ixed bin 
ptr unal , 
ptr unal , 



ca 1 l_channel 
2 wordO . 
3 priority 
3 type 
2 next_chanp 
2 prev_chanp 
2 word_3, 

3 cal 1_inhibit 
3 1nhib1t_count 
3 wakeup_count 
name 

f i rst_ev_msgp 
1 ast_ev_msgp 
data_ptr 
procedure_va 1 ue . 
3 procedure_ptr ptr unal 
3 env ironment_ptr 

ptr unal 

unused 



bit (72). 
ptr unal . 
ptr unal . 
(4) fixed bin; 

aligned based (ectep). 



(17) 
(17) 



bit (1) unal , 
f ixed bin ( 16) 
fixed bin ( 18) 
bit (72). 
ptr unal . 
ptr unal , 
ptr unal , 



1 event_message 
2 wordO, 

3 priority 

3 type 
2 next_ev_msgp 
2 messagedata 

2 chanp 

2 next_cal l_msgp 
2 unused2 

1 ittmessage 
2 word_0, 

3 unused 1 

3 type 
2 next_i tt_msgp 
2 messagedata 
2 unused2 



f ixed bin; 
al igned based, 



/♦ event channel name associated with this channel +/ 
/* pointer to first message in queue ♦/ 
/♦ pointer to last message in queue ♦/ 
/♦ pad to 12 words */ 

/♦ Event call channel - type = CALL */ 

unal. /♦ indicated priority relative to other call chns ♦/ 

unal . /♦ = CALL ♦/ 

/♦ pointer to next call channel */ 

/♦ pointer to prev call channel */ 

/+ = " i "b If call to associated proc In progress */ 
unal, / + number of times message reception has been inhibited */ 

unal unsigned, /* number of wakeups received over this channel */ 

/♦ event channel name associated with this channel */ 

/* pointer to first message in queue */■ 

/* pointer to last message in queue +/ 

/* pointer to associated data base */ 

/+ procedure to call when message arrives */ 

/* pointer to csntry point */ 

/* pointer to stack frame */ 
/* pad to 12 words */ 

/♦ Event message - type = EV_MESSAGE */ 



fixed bin ( 17) unal . 
fixed bin (17) unal, 
ptr unal , 



/* priority of call channel */ 
/* = EV_MESSAGi: •/ 

/* pointer to next message, for this channel */ 
like event_message_data aligned, 

/+ event message as returned from 1pc_$block */ 
ptr unal. /+ pointer to associated event channel */ 

ptr unal, /* pointer to next event call channel message */ 

(2) fixed bin; /♦ pad to 12 words ♦/ 



al igned based, 



/* Itt message - type = ITTMESSAGE */ 



f ixed bin ( 17) unal ,. 
f ixed bin ( 17) unal . 

ptr unal, /* pointer to next Itt message entry in ECT currently */ 

like event_message_data aligned. 

(4) fixed bin; /♦ pad to 12 words ♦/ 



del 



1 event channel name 



2 ecteptr 

2 ring 

2 uniquejd 



al Igned based, 
ptr unal , 



/* description of name of channel */ 

/* pointer to channel entry in ECT */ 

/* = null if fiast channel */ 

fixed bin (3) unal unsigned, /* ring number of ECT +/ 

fixed bin (33) unal unsigned; /* Identified unique to the process */ 
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del 



del 



1 f ast_channel_name aligned based. 
2 ecte_ptr ptr una!, 

2 ring fixed bin (3) unal unsigned, 

2 mbz bit (15) unal , 

2 channe1_1ndex fixed bin (17) unal; 



1 event _message_data 

2 channel _1d 
2 message 
2 sender 
2 origin, 

3 dev_s1gnal 



al Igned based, 
fixed bin (71), 
fixed bin (71), 
bit (36), 



/* 



3 ring 
END INCLUDE file 



bit (18) unal, 
fixed bin ( 17) unal ; 
. ect_structures . 1nc1 .pi 1 +/ 



/* description of name of of fast channel */ 

/* ■ null fast channel */ 

/* A = null full event channel */ 

/* target ring number */ 

/* number of special channel +/ 



/* template for event message */ 
/* event channel name */ 

/* 72 bit message associated with wakeup */ 
/* process If of sender +/ 

/* T'b If device signal +/ 
/* "0 H b If user event +/ 
/♦ring of sending process */ 
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eventwa i t 1 1st . Incl .pi 1 



segment »n: > 1 dd> I nc 1 ude contents modified: 06/07/79 1406.5 

entry modified: 03/ 10/82 0836.7 



/* BEGIN INCLUDE FILE ... eventual t_l 1st . Incl .pi 1 */ 

/* ipc_$block wait 11st structure -- MUst begin on an even word boundary. 
Written 9-May-79 by M. N. Davldoff. 



*/ 



dec 1 are event wa 1 t_l 1 stn channe 1 s 

fixed binary; 
declare event_wa1 t_l 1st_ptr pointer; 



declare 1 event_wa 1 t_1 1 st 
2 n_channe 1 s 
2 pad 

2 channel 1d 



aligned based (eventwa 1 t_1 lst_ptr) , 

fixed binary, /* number of channels In wait list */ 

bit (36). 

(event_wa 1 t_l lst_n_channel s refer (event_wa1 t_l 1st . nchannels) ) fixed binary (71); 

/♦ event channels to wait on +/ 



/* END INCLUDE FILE 



event_walt_1 1st. Incl .pi 1 */ 
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f aul t_vector „ incl .pi 1 



segment in: > 1 dd> I nc I ude contents modified: 06/10/81 1658.7 

entry modified: 03/10/82 0836.9 



/* BEGIN INCLUDE FILE^ . . . f aul t_vector . Incl .pll ... last 
del fvp ptr; 

del 1 fv based (fvp) aligned, 
2 Ipalr (0: 31). 

3 scu bit (36), 

3 tra bit (36), 
2 fpalr (0: 31). 

3 scu bit (36). 

3 tra bit (36), 
2 1_tra_ptr (O: 31) ptr, 
2 Iscu ptr (0: 31) ptr, 
2 f_* ra _Ptr (O: 31) ptr, 
2 f_scu_ptr (O: 31) ptr; 

/* Fault Types by fault number 



del (FAULT 


NO 


SDF 


Inlt 


(0). 


fault" 


"no 


STR 


Inlt 


(1). 


fault" 


"no" 


MME 


Inlt 


(2). 


fault" 


"no" 


~F1 


Inlt 


(3). 


fault" 


"no" 


TRO 


Inlt 


(4). 


FAULT* 


"no" 


CMD 


Inlt 


(5). 


FAULT* 


"no" 


"drl 


Inlt 


(6). 


FAULT 


NO 


LUF 


Inlt 


(7). 


FAULT* 


NO 


"con 


Inlt 


(8). 


FAULT* 


"no" 


"par 


Inlt 


(9). 


FAULT* 


"no" 


IPR 


Inlt 


(10). 


FAULT 


NO 


ONC 


Inlt 


(ID. 


FAULT 


NO 


SUF 


1n1t 


(12). 


FAULT* 


"NO* 


OFL 


Inlt 


(13). 


FAULT 


NO 


DIV 


inlt 


(14). 


FAULT 


NO 


EXF 


Inlt 


(15). 


FAULT 


NO 


DFO 


inlt 


(16). 


FAULT 


NO 


OF 1 


Inlt 


(17). 


FAULT 


NO 


DF2 


Inlt 


(18). 


FAULT 


NO 


DF3 


1n1t 


(19). 


FAULT" 


NO ACV 


1nit 


(20), 


FAULT* 


NO MME2 


1n1t 


(21). 


FAULT 


NO 


MME 3 


Inlt 


(22). 


FAULT NO 


MME 4 


Inlt 


(23), 


FAULT NO 


"F2 


Inlt 


(24). 


FAULT NO 


F3 


Inlt 


(25). 


FAULT. 


.NC/JTRB 


Inlt 


(31) 



) fixed bin ( 17) Int sta 



modified February 1981 +/ 

/* pointer to the fault and Interrupt vectors */ 

/* fault and Interrupt vectors */ 

/* Interrupt pairs */ 

/* SCU Instruction */ 

/* TRA Instruction */ 

f*> f aul t pairs */ 

/* SCU Instruction */ 

I '* TRA Instruction +/ 

/* ITS pair for Interrupt TRA Instruction */ 

/* ITS pair for Interrupt SCU Instruction */ 

/* ITS pairs for fault TRA Instruction +/ 

/* ITS pairs for fault SCU Instruction */ 









+ / 


/* 


Shutdown 




*/ 


/* 


Store 


*/ 




/♦ 


Master Mode Entry 1 




*/ 


/* 


Fault Tag 1 




*/ 


/* 


Timer Runout 




*/ 


/* 


Command 




♦/ 


/* 


Derail 




*/ 


/* 


Lockup 




*/ 


/+ 


Connect 




*/ 


/* 


Par 1 ty 




*/ 


/* 


1 1 1 ega 1 Procedure 




*/ 


/.* 


Operation Not Complete 




♦/ 


/* 


Startup 




*/ 


/* 


Overflow 




*/ 


/* 


Divide Check 




*/ 


/* 


Execute 




*/ 


/* 


Directed Fault 0 (Segment Fault) 




*/ 


/* 


Directed Fault 1 (Page Fault) 




*/ 


/* 


Directed Fault 2 




*/ 


/* 


Directed Fault 3 




*/ 


/• 


Access Violation 




*/ 


/* 


Master Mode Entry 2 




*/ 


/♦ 


Master Mode Entry 3 




*/ 


/* 


Master Mode Entry 4 




*/ 


/♦ 


Fault Tag 2 (Linkage Fault) 




*/ 


/* 


Fault Tag 3 




♦/ 


/* 


Fault Numbers 26-30 unassigned 




*/ 


/* 


Trouble 




*/ 



tic options (constant); 
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/* END INCLUDE FILE ... faul tvector . incl .pi 1 */ 
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c qaa - Unt tn ho renroduced 



fgbx.lncl.pll segment In: > 1 dd> 1 nc 1 ude contents modified: 09/17/82 1333.2 

entry modified: 09/17/82 1333.3 



/* BEGIN INCLUDE FILE ... fgbx. Incl .pi 1 */ 

/* last modified 5/3/77 by Noel I. Morris */ 

/* Modified 8/79 by R.J.C. Kissel to add FNP blast message. 

/* Modified 7/82 BIM for recognizable sentinel field ♦/ 



*/ 



/* The contents of this segment are data shared by Multics and BOS. 

This segment occupies the 2nd, 3rd, 4th, and 5th 16-word blocks of the BOS toehold. */ 



del 
del 

del 



f1agbox$ ext; 
fgbxp ptr; 

1 fgbx based (fgbxp) aligned, 

2 flags (36) bit (1) unal. 
2 s1t_segno bit (18), 

2 padl fixed bin, 
2 rtb. 
(3 ssenb bit (1), 

3 ca11_bos bit (1). 

3 shut bit (1). 

3 mess bit ( 1 ) , 

3 alert bit (1), 

3 pad bit (25), 

3 bos_entry fixed bin (5)) unal 



2 sentinel char (32) aligned, 
2 sst_sdw bit (72), 
2 hc_dbr bit (72), 
2 message char (64), 
2 f npblast char (128); 



/* communications switches */ 
/* segment H of the SLT +/ 

/* return to BOS Info */ 
/* " 1"b If storage system enabled */ 
/* "1"b 1f BOS called by operator */ 
/* "1"b If BOS called after shutdown */ 
/* "1"b If message has been provided +/ 
/* "1"b If audible alarm to be sounded */ 

/* type of entry Into BOS 

0 «> XED 10002 (BOS entry) 

1 «> XED 10004 (Multics entry) 

2 ■> XED 10000 (manual entry) */ 
/* set by BOS (for now) */ 

/* set by 1n1t_sst */ 

/* set by start_cpu. Idle DBR */ 

/* message for return to BOS */ 

/* message for FNP use when Multics Is down. */ 



declare F L AGBOX_SENT I NE L char (32) Inlt ("Flagbox ft Toehold Valid") Int static options (constant): 



/* END INCLUDE FILE 



fgbx. Incl .pi 1 */ 



1 nc 1 ude + , hard . source 
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fs_dev_types.1nd.pH segment In: >ldd> Include contents modified: 02/09/81 1416.2 

entry modified: 03/10/82 OS36.8 

/* Begin include file ...... f s_dev_types. incl .pi 1 ♦/ 

/♦ Modified 5/19/76 by N. I. Morris ♦/ 

/* Modified 12/27/78 by Michael R . 'Jordan to correct MSS0500 information */ 

/♦ Modified 4/79 by R.d.C. Kissel to add msu050t Information. */ 

del (maxdevt inlt (7), /* maximum legal devt ♦/ 

bulkdevt Inlt (1). /♦ bulk store devt ♦/ 

msu0500devt in it (2) 0 /♦ MSU0500 device type ♦/ 

msu0451devt inlt (3), /♦ MSU0451 device type */ 

msu0450devt init (3), /+ MSU0450 device type +/ 

msu0400devt init (4). /* MSU0400 device type */ 

dsu191devt init (4), /* DSU191 device type ♦ / 

dsu190devt Inlt (5). /* 0SU19O device type ♦/ 

dsu181devt Init (6), /♦ DSU181 device type ♦/ 

msu0501devt Init (7) /♦ MSU0501 device type +/ 
) fixed bin (4) static options (constant); 

del MODEL (10) fixed bin static options (constant) Init /♦ Known device mode) numbers */ 
(0, 500. 451, 450. 400, 402. 191. 190, 181. 501); 

del M0DELX (10) fixed bin static options (constant) Init /♦ translation from model number to device type */ 
( 1 . 2. 3. 3. 4. 4. 4. 5. 6. 7); 

del MODE LN (7) fixed bin static options (constant) Inlt /* translation from 'device type to model number */ 
(0. 500. 451, 400. 190. 181, 501): 

del dev1ce_names (7) char (4) aligned static options (constant) Inlt ( /♦ device names indexed by device type */ 
"bulk". "d500". "d451 H , "d400". "d190", "dial". M d501 M ); 

del media removable (7) bit (1) static options (constant) inlt /* ON ■> demountable pack on device */ 
("0"b, "0"b, "1 M b, H 1 M b, "1"b. " 1"b, "0"b); 

del shared_sp indie (7) bit (1) static options (constant) Inlt /* ON *> 2 devices per spindle */ 
CO"b. "1"b, "0 H b„ M 0"b, "0"b, "0"b, "1"b); 

del rec_per_dev (7) fixed bin static options (constant) Init /* table of H of records on each device */ 
(O. 38258. 38258. 19270. 14760. 4444, 67200); 

del cyl_per_dev (7) fixed bin static options (constant) Inlt /♦ table of 0 of cylinders on each device */ 
(0. 814, 814. 410, 410. 202. 840); 

del rec_per_cyl (7) fixed bin static options (constant) Inlt /* table of It of records per cylinder on each device */ 
(O. 47. 47. 47, 36. 22. 80); 

del sect_per_cyl (7) fixed bin static options (constant) inlt /+ table of U of sectors per cylinder on each device */ 
(0. 760. 760, 760, 589. 360. 1280); 

del sect_per_rec (7) fixed bin static options (constant) init /♦ table of U of sectors per record on each device ♦/ 
(0. 16. 16. 16. 16. 16, 16); 
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del tracks__per_cy 1 (7) fixed bin static options (constant) Inlt /* table of ff of tracks per cylinder on each device +/ 
(0, 19. 19. 19. 19. 20. 20); 

del sect_per track (7) fixed bin static options (constant) Inlt /* table of ff of sectors per track on each device */ 
(0. 40. 40. 40. 31, 18. 64); 

del words_per_8ect (7) fixed bin static options (constant) inlt /* table of ff of words per sector on each device */ 
(0. 64. 64, 64. 64. 64. 64); 

del f irst_rec_num (7) fixed bin static options (constant) Inlt /* table of ff of first record on each device */ 
(0, 0. 0, 0, 0, 0, 0); 

del 1ast_rec_num (7) fixed bin (18) static options (constant) 1n1t /* table of ff of last record on each device */ 
(0. 38257, 38116, 19128. 14651, 4399, 67199); 

del f 1rst_sect_num (7) fixed bin (24) static options (constant) inlt /* table of ff of first sector for each device */ 
(0, 0, 0, 0, 0. 0, 0); 

del last_sect_num (7) fixed bin (24) static options (constant) Inlt /* table of ff last sector number for each device +/ 
(0. 618639. 616359, 309319, 239722. 71999. 1075199); 

del f 1rst_al t_sect num (7) fixed bin (24) static options (constant) 1n1t /+ table of ff of first sector of alt partition */ 
(0. 638400, 616360. 309320. 239723. 72000, 1075200); 

del last alt sect num (7) fixed bin (24) static options (constant) Inlt /* table of ff of last sector of alt partition */ 
(0. 639919, 618639, 311599, 241489, 72719, 1077759); 

del 1ast__phys1cal_Sect_num (7) fixed bin (24) static options (constant) Inlt /* table of ff of last sector on device (includes T&D c 
yllnders) +/ 

(0, 639919. 619399, 312359, 242249, 72359, 1077759); 

del dev_t1me (7) float bin (27) static options (constant) Inlt /* table of average access times for each device +/ 
(384e0. 33187eO. 33187eO, 34722e0. 46935e0. 52631eO. 33187e0); 

/* End of Include file f s_dev_types . Incl .pi 1 */ 
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f s_types. Incl .pi 1 segment In: > ldd> Include contents modified: 05/18/77 0819.5 

entry modified: 03/ 10/82 O830.6 

/♦ BEGIN INCLUDE FILE ... fs_types. Incl .pi 1 ♦/ 

del ACCESS_NAME_TYPE bit (18) static options (constant) Inlt ( "000001 H b3 ) ; 

del ACLE_TYPE bit (18) static options (constant) Inlt ( "000002"b3) ; 

del DIR_HEADER TYPE bit (18) static options (constant) Inlt ( "000003 "b3) ; 

del DIR_TYPE bit (18) static options (constant) Inlt ( "000004 "b3 ) ; 

del LINK_TYPE bit (18) static options (constant) inlt ( H 000005"b3) ; 

del NAME_T YPE bit (18) static options (constant) Inlt ( "000006 "b3 ) ; 

del SEG TYPE bit (18) static options (constant) Inlt ( "000007 "b3 ) ; 

del HASH TABLE TYPE bit (18) static options (constant) inlt ( "0000l3"b3) ; 

m 

del access name_ type fixed bin static options (constant) inlt (1): 

del acle_type fixed bin static options (constant) inlt (2); 

del dlr_header_type fixed bin static options (constant) Inlt (3): - 

del dlr_type fixed bin static options (constant) inlt (4); 

del 11nk_type fixed bin static options (constant) Inlt (5); 

del nametype fixed bin static options (constant) inlt (6); 

del segtype fixed bin static options (constant) inlt (7); 

del hashtabl etype fixed bin static options (constant) inlt (11); 

/* END INCLUDE FILE ... f s_types . incl . pi 1 */ 
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f s_vol_1abel . incl .pi 1 * segment In: >ldd> Include contents modified: 05/20/82 1037.5 

entry modified: 05/20/82 1047.6 



/* BEGIN INCLUDE FILE ... f s_vo1_1abe1 . 1nc1 .pi 1 .. last modified January 1982 for new volume map format */ 
/* This Is the label at fixed location of each physical volume. Length 1 page */ 
del labelp ptr; 

del 1 label based (labelp) aligned, 

/* First comes data not used by Multlcs.. for compatibility with GCOS */ 

2 gcos (5*64) fixed bin, 
/* Now we have the Multlcs label */ 



2 


Multlcs char (32) 1n1t ("Multlcs 


Storage System Volume"), 


, /* Identifier */ 


2 


version fixed bin, 
mfg_ser1a1 char (32), 


/* 


Version 1 */ 


2 


/* 


Manufacturer's serial number */ 


2 


pvname char ( 32 ) , 


/* 


Physical volume name. */ 


2 


lv name char (32), 


/* 


Name of logical volume for pack */ 


2 


pvld bit (36), 


/* 


Unique ID of this pack +/ 


2 


ivld bit (36). 


/* 


unique ID of Its logical vol */ 


2 


root_pv1d bit (36), 


/* 


unique ID of the pack containing the root, everybody must agree. */ 


2 


t 1me_reg1stered fixed bin (71), 


/* 


time Imported to system */ 


2 


n_pv_ 1n_1 v fixed bin. 


/* 


(f phys volumes In logical */ 


2 


vol_size fixed bin. 


/* 


total size of volume. In records */ 


2 


vtoc_s1ze fixed bin. 


/* 


number of recs in fixed area + vtoc */ 


2 


not_used bit (1) unal , 


/* 


used to be mul t 1p1e_cl ass */ 


2 


private bit (1) unal, 


/* 


TRUE If was registered as private */ 


2 


flagpad bit (34) unal. 




Maximum access class for stuff on volume ♦ / 


2 


max_access_c1ass bit (72), 


/* 


2 


m1n_access_class bit (72), 


/* 


Minimum access class for stuff on volume */ 


2 


password bit (72), 


/* 


not yet used */ 


2 


padl ( 16) fixed bin, 






2 


t1me_mounted fixed bin (71), 


/* 


time mounted */ 


2 


t 1me_map_updated fixed bin (71), 


/* 


time vmap known good */ 



/* The next two words overlay t ime_unmounted on pre-MRIO systems. This 
forces a salvage If an MR10 pack Is mounted on an earlier system. 



2 


vo1map_version fixed bin. 




version of volume map (currently 1) */ 


2 


pad6 fTxed bin. 






2 


time salvaged fixed bin (71), 


/♦ 


time salvaged */ 


2 


t 1me_of_boot fixed bin (71), 


/♦ 


time of last boot load */ 


2 


t Imeunmounted fixed bin (71), 


/* 


time unmounted cleanly +/ 


2 


last pvtx fixed bin, 


/* 


pvtx in that PDMAP *-/ 


2 


padla (2) fixed bin. 






2 


err hist size fixed bin. 


/* 


size of pack error history */ 


2 


time_1ast_dmp (3) fixed bin (71), 


/* 


time last completed dump pass started +/ 
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2 


time last reloaded f i,xed bin (71), 




what It says */ 


2 


pad2" (40) f Ixed bin. 






2 


root , 








3 here bit (1). 


/* 


TRUE If the root Is on this pack ♦/ 




3 rootvtocx fixed bin (35), 


/♦ 


VTOC index of root, if it is here ♦/ 




3 shutdown state fixed bin, 


/* 


Status of hierarchy */ 




3 pad7 bit ( 1 ) al igned, 








3 disk table vtocx fixed bin, 


/* 


VTOC Index of disk table on RPV ♦/ 




3 disk_tab1e_u1d bit (36) aligned. 


/* 


U ID of disk table */ 




3 esd_state fixed.bin. 


/* 


Slate of esd */ 


2 


volmap_record fixed bin, 


/♦ 


Begin record of volume map +/ 


2 


s 1 ze_of _volmap fixed bin. 


/♦ 


Number of records in volume map ♦/ 


2 


v toc map record fixed bin. 


/♦ 


Begin record of VTOC map +/ 


2 


s i ze of __vtoc_map fixed bin. 


/♦ 


Number of records in VTOC map +/ 


2 


volmap_unit_s1ze fixed bin, 


/* 


Number of words per volume map section +/ 


2 


vtoc_or 1gin_record fixed bin. 


/♦ 


Begin record of VTOC ♦/ 


2 


dumper _b 1 t_map__record fixed bin, 


/♦ 


Begin record of dumper bit-map */ 


2 


vol trouble count fixed bin. 


/* 


Count of Inconsistencies found since salvage 


2 


pad3 (52) fixed bin. 






2 


nparts f ixed bin, 


/♦ 


Number of special partitions on pack */ 


2 


parts (47), 








3 part char (4), 


/* 


Name of partition */ 




3 free fixed bin. 


/* 


First record */ 




3 nrec fixed bin. 


/■* 


Number of records ♦/ 




3 pad5 f Ixed bin, 






2 


pad4 (5*64) f ixed bin: 







del Mul t 1cs_ID_Str Ing char (32) Init ("Multics Storage System Volume") static; 
/* END INCLUDE FILE f s_vol_1abe1 . Incl .pi 1 */ 
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hc_lock. Incl .pi 1 segment In: >'ldd l > Include contents modified: 04/14/82 1336.1 

entry modified: 04/14/82 1337.7 



/* Begin Include file hemlock . Incl .pi 1 BIM 2/82 */ 

/* Lock format suitable for use with 1ock$ lock_f ast , un1ock_fast */ 
/♦ format: styles */ 



declare 
declare 



lock ptr 
1 lock 
2 pld 
2 event 
2 flags 

3 not 1 f y_sw 
3 pad , 



pointer : 

aligned based (lockptr), 
bit (36) al Igned, 
bit (36) al Igned. 
al igned, 

bit ( 1 ) unal Igned, 
bit (35) unaligned; 



/* holder of lock */ 

/* event associated with lock */ 



/* certain locks use this pad. like dirs +/ 



/* End Include file hc_1ock . Incl .pi 1 */ 
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i ttontry . incl .pi 1 



segment In: 
entry modified: 



> 1 dd> i nc 1 ude 
03/10/82 0837.0 



contents modified: 08/06/81 1825.8 



/* 



BEGIN INCLUDE FILE 



/* format: style3 */ 
del 1tte_ptr 



del 



1 tt_entry 

2 next_1 tt_relp 

2 pad 

2 sender 

2 origin. 

3 dev_s1gnal 

3 ring 
2 targeted 
2 channel_1d 
2 message 



1tt_entry. Incl .pi 1 



ptr ; 

aligned based (1tte_ptr), 
bit' (18) unaligned, 
bit (18) unal igned, 
bit (36). 

bit (18) unal igned, 
fixed bin (17) unaligned, 
bit (36). 
fixed bin (71). 
fixed bin (71); 



Feb 1981 */ 



/♦ pointer to entry in ITT +/ 

/♦ declaration of single entry in the ITT */ 
/* thread of relative pointers */ 

/♦. id of sending process */ 

/+ origin of event message */ 

/ * 0 = user-event, 1 = device-signal */ 

/* if user-event, sender's validation ring */ 

/.* target process' id */ 

/* target process' event channel */ 

/* event message */ 



/* 



END INCLUDE FILE 



1 ttentry . incl .pi 1 */ 
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kst. incl .pi 1 



segment In: > ldd> Include contents modified: 03/14/83 1654.3 

entry modified: 03/ 14/83 1655.6 



/* BEGIN INCLUDE FILE 



- kst. Incl .pi 1 



last modified March 1976 by R. Bratt */ 



del pds$kstp ext ptr, 
(kstp, kstep) ptr; 



del 



del 



1 kst aligned based (kstp). 

2 lowseg fixed bin (17), 
2 hlghseg fixed bin (17), 

2 hlghest_used_segno fixed bin (17), 

2 lvs fixed bin (8), 

2 t1me_of_bootload fixed bin (71), 

2 garbage_col lect tons fixed bin (17) unaligned, 

2 entr 1es_co1 lected fixed bin (17) unaligned, 

2 f ree_1 1st bit (18) unaligned, 

2 prel 1nked_r Ing (7) bit (1) unaligned, 

2 template bit (1) unaligned, 

2 al 1ow_256K_connect bit (1) unaligned, 

2 unused_2 bTt (9) unaligned, 

2 u1d_hash_bucket (O : 127) bit (18) unaligned, 
2 kst_entry (O refer (kst . lowseg) :0 refer (kst. 
2 1v ( 1 :256) bit (36). 
2 end_of_kst bit (36); 

1 kste based (kstep) aligned, 

2 fp bit (18) unaligned, 

2 segno fixed bin (17) unaligned, 

2 usage_count (0:7) fixed bin (8) unaligned, 

2 entryp ptr unaligned, 

2 u1d bit (36) aligned, 

2 access_ Information unaligned, 

3 dtbm bit (36). 

3 extendedaccess bit (33). 

3 access bit (3), 

3 ex rb (3) bit (3), 
2 hdr bit (3) unaligned. 
2 flags unaligned, 

3 dlrsw bit (1). 

3 al low write bit (1), 

3 prtv Tnlt bit ( 1 ) , 

3 tms bit (1), 

3 tus bit (1), 

3 tpd bit (1), 

3 audit bit (1), 

3 expl 1c1t_deact_ok bit (1). 

3 pad bit (3), 
2 inf count fixed bin (12) unaligned; 



/* KST header declaration */ 
/* lowest segment number described by kst */ 
/* highest segment number described by kst */ 
/* highest segment number yet used */ 

/* number of private LVs this process Is connected to */ 
/* bootload time during prel Inking */ 
/+ KST garbage collections */ 

/* KST entries recovered by garbage collection +/ 
/* relative pointer to first free kste +/ 
/+ rings prel Inked In process */ 
/* this Is a template kst If set */ 
/* can use 256K segments */ 

/* hash buckets */ 
hlghseg)) aligned like kste. /* kst entries +/ 

/* private logical volume connection list */ 



*/ 



/+ KST entry declaration ■ 
/* forward rel pointer */ 
/* segment number of this kste */ 
/* outstanding Initiates/ring */ 
/* branch pointer */ 
/* unique Identifier */ 



/* date time branch modified */ 

/* extended eiccess from the branch */ 

/* rew */ 

/* ring brackets from branch */ 
/+ highest detectable ring */ 

/* directory switch */ 

/* set 1f Initiated with write permission */ 

/* privileged Initiation */ 

/* transparent modification switch +/ 

/* transparent usage switch */ 

/* transparent paging device switch */ 

/* audit switch */ 

/* set If I «m willing to have a user force deactivate */ 
/* J_f dlrsw i t hen inferior count el se 1v index */ 



/* END INCLUDE FILE 



kst . Incl .pi 1 



*/ 
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lock_array . incl .pi 1 segment In: > ldd> inc lude contents modified: 04/14/82 1336.2 

entry modified: 04/14/82 1337.7 



/* BEGIN INCLUDE FILE ... 1 ock_array . Inc 1 . pi 1 +/ 

/* modified BIM 2/82 to clean up ♦ / 
/* format: styles */ 



del 



1 pds$1ock__array 



(0:19) external aligned like pdsentry; 



del 



1 pdsentry 

2 lock.ptr 

2 event 

2 flags 

3 dir_1ock 
3 one_word 
3 pad 

2 cal 1er_ptr 



based, 
pointer, 

bit (36) al igned, 
al igned, 

bit (i) unaligned, /+ This Is a dir read lock +/ 
bit (1) unaligned, /* lock$wait */ 
bit (34) unaligned, /♦ else lock$lock_fast */ 
pointer ; 



/* 



END INCLUDE FILE 



1ock_array . incl .pi 1 +/ 
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1 vt . Incl .pi 1 



segment In: > 1 dd> 1 nc 1 ude contents modified: 11/22/76 1025.1 

entry modified: 03/ 10/82 0836.6 > 



/* BEGIN INCLUDE FILE 1vt.1ncl.p11 -- Written dan. 1976 by R . Bratt ♦/ 
/* 

This Include file defines the format of the hardcore Logical Volume Table (LVT). 

♦/ ~ " ■ 

del lvt$ ext; 
del Ivtp ptr; 
del Ivtep ptr; 



del 1 lvt aligned based (Ivtp), 
2 max_1vtex fixed bin (17), 
2 h1gh_water_1vtex fixed bin (17), 
2 free_lvtep ptr, 
2 padl (4) bit (36). 
2 ht (0:63) ptr unal, 

2 lvtes (1:1 refer ( 1 vt .max_1 vtex) ) like Ivte; 

del 1 lvte aligned based (Ivtep), 
2 ivtep ptr unaligned, 
2 pvtex fixed bin (17), 
2 ivld bit (36), 
2 access class aligned, 

3 mln bit (72), 

3 max bit (72). 
2 flags unaligned, 

3 publ 1c bit (1), 

3 read_on1y bit (1). 

3 pad bit (16). 

3 cyc1e_pvtx fixed bin (17); 

/* END INCLUDE FILE 1vt.1ncl.p11 



/* maximum number of LVs descrlbable */ 
/* highest LVT Index assigned ♦/ 
/* pointer to first free lvte */ 

/* Ivld hash table */ 
/* LVT entries */ 

/* logical volume table entry */ 

/* ivld hash thread */ 

/* thread of mounted PVs */ 

/* logical volume Id +/ 

/* access Isolation mechanism stuff */ 

/* minimum access class allowed on LV */ 

/* maximum access class allowed on volume */ 

/♦ flags */ 

/* -> anyone can connect to this LV */ 
/* ■> no writes on this LV */ 

/* pvtx for next perprocess seg */ 

*/ 
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mc.lncl.pll segment In: > 1dd> 1nc lude contents modified: 09/08/8 1 1426.4 

entry modified: 03/10/82 0837.0 



/* 
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*/ 

/* BEGIN INCLUDE FILE mc.1ncl.pH Created Dec 72 for 6180 - WSS. +/ 

/* Modified 06/07/76 by Greenberg for mc.restgnal */ 

/♦ Modified 07/07/76 by Morris for fault register data */ 

/* Modified 08/28/80 by J. A. Bush for the DPS8/70M CVPU ♦/ 



/+ words 0-15 pointer registers +/ 



del mcp ptr; 

del t mc based (mcp) a! tgned, 
2 prs (0:7) ptr, 
(2 regs, 

3 x (0:7) bit (18). 

3 a bit (36). 

3 q bit (36). 

3 e bit (8). 

3 pad1 bit (28), 

3 t bit (27), 

3 pad2 bit (6), 

3 ralr bit (3), 

2 scu (0:7) bit (36). 

2 mask bit (72), 

2 ips_temp bit (36), 

2 errcode fixed bin (3S), 

2 f1m_temp, 

3 un1que__1ndex bit (18) unal , 
3 reslgnal bit (1) unal, 
3 fcode bit (17) unal , 

2 fault reg bit (36), 

2 pad2 bit (1). 

2 cputype fixed bin (2) unsigned, 
2 ext fault_reg bit (15), 
2 fault time bit (54), 



/+ POINTER REGISTERS */ 

/♦ register's */ 

/♦ index registers +/ 

/* accumulator */ 

/* q-reglsi:er */ 

/+ exponent */ 

/* timer register */ 

/* ring alarm register */ 



/* mem comtroller mask at time of fault */ 
/* Temporary storage for IPS Info */ 
/+ fault handler's error code */ 

/+ unique index for restarting faults */ 

/* recompute signal name with fcode below */ 

/* fault code used as Index to FIM table and 5CT */ 

/* fault register +/ 

/* L68 - 0, DP58/70M - 1 */ 

/* extended fault reg for DPS8/70M CPU */ 

/* time of fault */ 



2 elslnfo (0:7) bit (36)) unaligned; 



del (apx fixed bin init (0). 

abx fixed bin init (1), 

bpx fixed bin init (2). 

bbx fixed bin Init (3). 

ipx fixed bin Init (4). 

lbx fixed bin Init (5), 

spx fixed bin init (6), 

sbx fixed bin init (7)) internal static; 
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del scup ptr; 



del 1 scu based (scup) aligned. /♦ SOU DATA */ 

/* WORD (O) ♦/ 



PPr, 


/• 


PROCEDURE POINTER REGISTER */ 


3 prr bit (3), 


/* 


procedure ring register */ 


3 psr bit ( 15). 


/• 


procedure segment register */ 


3 n hit ( 1 ) 


/ + 


nrnrpdurp nr i v/ i 1 onpri hit* + / 


apu, 


•/* 


APPENDING UNIT STATUS */ 


3 xsf bit (1), 


/* 


ext seg flag - IT modification */ 


3 sdwm bit ( 1 ) . 


/* 


match In SOW Ass. Mem. ♦ / 


3 sd an bit (1). 


/• 


SOW Ass. Mem. ON */ 


3 ptwm bit (1). 


/♦ 


match In PTW Ass. Mem. */ 


3 pt on bit (1), 


/* 


PTW Ass. Mem. ON */ 


3 pi ap bit ( 1) . 


/* 


Instr Fetch or Append cycle */ 


3 dsptw bit (1). 


/* 


Fetch of DSPTW */ 


3 sdwnp bit ( J ) . 


/* 


Fetch of SDW non paged */ 


3 sdwp bit (1). 


/* 


Fetch of SDW paged */ 


3 ptw bit ( O . 


/* 


Fetch of PTW */ 


3 ptw2 bit ( 1) . 


/* 


Fetch of pre-paged PTW */ 


3 fap bit ( O. 


/* 


Fetch of final address paged +/ 


3 fanp bit < O . 


/* 


Fetch of final address non-paged */ 


3 fabs bit ( O. 


/♦ 


Fetch of final address absolute */ 


faultcntr bit (3), 


/• 


number of retrys of EIS instructions */ 



/* WORD ( 1 ) */ 



f d. 


/* 


FAULT DATA */ 


3 i ro bit ( 1 ) , 


./• 


illegal ring order */ 


3 oeb bit ( 1 ) , 


/* 


out of execute bracket */ 


3 e off bit ( 1 ) . 


/* 


no execute */ 


3 orb bit ( 1)„ 


/* 


out of read bracket */ 


3 r off bit ( 1) . 


/♦ 


no read */ 


3 owb bit ( 1 ) , 


/* 


out of write bracket */ 


3 w off bit ( 1 ) . 


/♦ 


no write +/ 


3 no ga bit ( 1 ) . 


/♦ 


not a gate */ 


3 oeb bit (1), 


/* 


out of call bracket */ 


3 ocal 1 bit ( 1) , 


/♦ 


outward cal 1 ♦/ 


3 boc bit ( 1 ) . 


/* 


bad outward call */ 


3 inret bit ( 1 ) , 


/* 


inward return */ 


3 crt bit (1), 


/> 


cross ring transfer */ 


3 ralr bit (O. 


/* 


ring alarm register +/ 


3 am er bit ( 1 ) , 


/* 


associative memory fault */ 


3 oosb bit ( 1) , 


/* 


out of segment bounds +/ 


3 paru bit ( 1 ) . 


/♦ 


processor parity upper */ 


3 pari bit ( 1 ) , 


/* 


processor parity lower */ 


3 one 1 bit ( 1 ) , 


/♦ 


op not complete type 1 */ 
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3 onc_2 bit- (1). 

2 port_stat, 
3 ial bit (4). 
3 1ac bit (3), 
3 con_chan bit (3), 

2 f 1_num bit (5), 
2 f O lag bit (1). 



/* WORD (2) 

2 tpr, 

3 trr bit (3), 
3 tsr bit (15), 

2 pad2 bit (9), 

2 cpu_no bit (3), 

2 delta bit (6). 



/* WORD (3) 

2 word3 bit (18). 

2 tsr s tat , 
3 tana , 

4 prn bit (3). 

4 prv bit (1). 
3 tsnb, 

4 prn bit (3). 

4 prv bit (1). 
3 tsnc, 

4 prn bit (3), 

4 prv bit (1), 

2 tpr_tbr bit (6). 



/* WORD (4) 

2 11c bit ( 18), 

2 1r, 

3 zero bit (1), 

3 neg bit (1). 

3 carry bit ( 1 ) , 

3 ovf 1 bit (1), 

3 eovf bit (1), 

3 eufl bit (1), 

3 of 1m bit (1), 

3 tro bit (1), 



i nc 1 udr * , hard . source 
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/* op not complete type 2 ♦/ 

/* PORT STATUS */ 
/* Illegal action lines */ 
/* Illegal action channel */ 
/* connect channel */ 

/* (fault/ interrupt) number ♦/ 

/+ 1 ■> fault, 0 »> interrupt */ 



/♦ TEMPORARY POINTER REGISTER */ 
/* temporary ring register +/ 
/* temporary segment register */ 



/* CPU number */ 

/♦ tally modification DELTA */ 



/* TSR STATUS for 1,2,8.3 word instructions */ 
/* Word 1 status */ 



/* Word 1 
/* Word 1 
/* Word 2 
/* Word 2 
/* Word 2 
/* Word 3 
/* Word 



/* Word 3 



PR number +/ 
PR val id bit */ 
status */ 
PR number */ 
PR val Id bit */ 
status +/ 
PR number */ 
PR val Id bit */ 



/* TPR.TBR lleld */ 



/* INSTRUCTION COUNTER */ 

/* INDICATOR REGISTERS */ 
/* zero Indicator */ 
/* negative Indicator +/ 
/* carryry Indicator +/ 
/* overflow Indicator */ 
/* eponent overflow */ 
/* exponent underflow */ 
/+ overflow mask */ 
/+ tally runout */ 
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3 par bit ( 1 ) , 
3 parm bit ( 1 ) , 
3 bm bit ( 1 ) , 
3 tru bit ( 1 ) , 
3 m i f bit ( I ) , 
3 abs bit ( 1 ) . 
3 pad bit (4), 



/* WORD (5) */ * 

2 ca bit ( 18) , 



2 cu. 



3 


rf bit 


( 1). 


3 


rpt bit 


(1). 


3 


rd bit 


( 1). 


3 


rl bit 


(1). 


3 


pot bit 


(1). 


3 


pon b 1 t 


< 1). 


3 


xde bit 


(t). 


3 


xdo bit 


O). 


3 


poa b i t 


(1). 


3 


rfi bit 


(1). 


3 


its bit 


(1). 


3 


if bit 


(1). 



2 cpu_tag bit (6>) unaligned, 



/+ WORDS (6,7) */ 0 

2 evenjnst bit (36). 
2 odd_1nst bit (36); 



/* ALTERNATE SCU DECLARATION 



del 1 scux based (scup) aligned, 

(2 padO bit (36), 

2 fd. 

3 isn bit ( 1 ), 
3 ioc bit ( 1 ) . 
3 1 a_am bit ( i ) , 
3 Isp bit ( 1 ) , 
3 ipr bit ( 1 ) „ 
3 nea bit ( 1 ) , 
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/» parity error ♦/ 

/* parity mask */ 

/* 'bar mode */ 

/* truncation mode +/ 

/* multi-word instruction mode */ 

/* absolute mode ♦/ 



/* COMPUTED ADDRESS */ 

/+ CONTROL UNIT STATUS ♦/ 

/* on first cycle of repeat instr */ 

/* repeat Instruction */ 

/+ repeat double instruction */ 

/* repeat link instruciton */ 

/* IT modification */ 

/♦ return type instruction */ 

/* XDE from Even location ♦/ 

/* XDE from Odd location ♦/ 

/* operation preparation */ 

/* tells CPU to refetch instruction */ 

/* ITS modification */ 

/* fault occured during instruction fetch */ 

/* computed tag field */ 



/* even Instruction of faulting pair */ 
/* odd Instruction of faulting pair */ 



/* GROUP II FAULT DATA */ 

/* illegal segment number ♦/ 

/♦ Illegal op code +/ 

/* illegal address - modifier */ 

/* illegal slave procedure +/ 

/* Illegal procedure ♦/ 

/* non existent address */ 
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3 oobb bit (1), 
3 pad bit (29), 

2 pad2 bit (36), 

2 pad3a bit (18), 

2 tsr_stat (0:2), 
3 prn bit (3), 
3 prv bit (1). 

2 pad3b bit (6)) unaligned, 

2 pad45 (O: 1) bit (36), 

2 Instr (O: 1) bit (36); 

/* END INCLUDE FILE mc.1ncl.pH */ 



/* out of bounds */ 



/♦ T§R STATUS as an ARRAY */ 
/+ PR nuAiber */ 
/* PR val Id bit */ 



/* Instruction ARRAY */ 
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nul 1_addr esses. 1 nc 1 .pi 1 



segment In: > t dct> 1 nc I ude contents modified: 10/13/82 1310.8 

entry modified: 10/13/82 1311.9 



/* BEGIN INCLUDE FILE null _addresses . Incl . pi 1 */ 

del (pc_move_page_table_1_nul l_addr In It 
pc_move_page_table_2_nu11_addr Inlt 
get_aste_nul l_addr Inlt 
make_sdw_nul l_addr Inlt 
put_aste_nu1 1_addr Inlt 
page_bad_pd_nu 1 1 _addr Inlt 
1 1st_deposi t_nul T_addr Inlt 
getf 1 1 e_map_nu 1 1 _addr Inlt 
fill pagetab ) e nu 1 1 addr Inlt 
Ini t_sst_nul 1_addr Inlt 
get_f 1 le_map_v t_nul 1_addr Inlt 
unprotected_null _addr Inlt 
pagepar i ty_nu1 l_addr Inlt 
page_devpar 1 ty_nu 1 l_addr Inlt 
getf 1 1e_map_dumper_non_nul I addr Inlt 
pagebadnu 1 1 addr Inlt 
pagepr ob 1 em_nu 1 1 _addr Inlt 



'3770070"b3) , 
•3770100"b3) . 
'37701 10"b3) , 
■3770120"b3) . 
■3770130"b3), 
•3770150"b3) , 
'3770160"b3). 
, 3770170"b3), 
'3770200"b3), 
'37702 10 H b3), 
'3770220"b3). 

3770230"b3). 
•3770260"b3) , 

3770270 ,, b3). 
'3777720"b3). 

377024O"b3) , 

'3770250 M b3) ) bit (22) aligned static options (constant) 



del create_vtoce_four_nul l_addrs fixed bin (71) Int static Inlt (-1);/* 777777 777777 mm mm ♦/ 



del (create_vtoce_nul l_addr Inlt 
update_vtoce_nu!1_addr Inlt 
trunca tevtocef 1 1 l_nul 1 addr 1ni t 
truncate vtoce nul laddr Inlt 
pvsal v_nul 1_addr Inlt 
pvscavnu 1 1 _addr Inlt 
• vo 1 time re 1 oader_ nu 1 1 addr Inlt 
volumeretr iever nul I addr inlt 
sa I vt runca tenu 1 l_addr Inlt 

/* END INCLUDE FILE null_addresses . 1 ncl . pll */ 



"777777"b3) . 
"777776"b3) . 
"777775"b3), 
" 777002 B b3). 
" 777004 "b3). 
" 777006 "b3 ) . 
"777774 B b3). 
"777773"b3). 

"777005 "b3 ) ) bit (18) aligned static options (constant) 
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pds . cds 



segment In: > I dd>hard> source 

contents modified: 03/14/83 1653.3 



system Id: 37-20 
entry modified: 03/27/83 1807.2 



/ * ****** ***** * *********** ************************************ 

* * 

* Copyright, (C) Honeywell Information Systems Inc.. 1982 * 

* * 
*********************************************************** +/ 

/* PDS - The Process Data Segment 

Last modified (Date and reason): 
2/6/76 by S. Webber Initial coding 

9/17/76 by R. Bratt to add seg_fau1t, bounds_f aul t , vtoc_read, and vtoc_wr1te meters. 
11/03/76 by M. Weaver to extend stack header 

04/20/77 by M. Weaver to delete rntp and 7/77 to add name templatepdu 
06/07/78 by E . Donner to add r1ng_events (to prevent delayed 1pc wakeups) 
05/10/79 by B. Margul 1es to eliminate exmode_level 
05/09/79 by Mike Grady to use shared ring 0 stacks 

08/17/79 by 0. A. Bush for exp under/overflow restart switches ft cache parity diagnostics 
02/28/80 by B. Margul les to use the Include file for the default overflow 
08/26/80 by J. A. Bush for the DPS8/70M CPU 
value. 

02/23/81 by J. Bonglovannl to remove temp_mode_reg (moved to prds$mod«_reg_enab1ed) 
03/81 by E. Donner to remove next_ftt and ect_po Inters 
3/82 BIM for 1ock_array cleanup. 

11/82 by «J. Bonglovannl to make f orce_wr 1 te_l 1ml t per-rlng 
2/83 by E. N. Klttlltz for hfp exponent enabled. 

*/ 

/* ****************************************************** 

* * 

* * 

* Copyright (c) 1972 by Massachusetts Institute of * 

* Technology and Honeywell Information Systems, Inc. * 

* + 

* * 
****************************************************** */ 

/* format: styles , Id1nd25 */ 
pds: 

proc; 

/* This program creates the pds data base +/ 
/* Automatic */ 

del 1 cdsa aligned like cds_args; 

del code fixed bin (35); 
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/* Constants ♦/ 



del pdsname char (3) aligned static init ("pds") options (constant); 

del exclude_pad (i) char (32) aligned static options (constant) init ("pad*"); 

/ + Bu i 1 1 1 ns * / 

del (addr, bin, bit, hbound. mod, null, rel , size, string, unspec) 

builtin; 

/* Entries ♦/ 

dci com_err_ entry options (variable); 

del create_data_segment_ entry (ptr, fixed bin (35)); 

del gettempsegment^ entry (char ( + ). ptr. fixed bin (35)); 

del re1ease_temp_segment_ entry (char (*), ptr, fixed bin (35)); 

del hcs_$chname_f i le entry (char (*), char (*), char (♦). char (*). fixed bin (35)); 

del get_wdir_ entry () returns (char (168)); 

/+ External Static */ 

del error_table_$segnamedup fixed bin (35) ext; 



inc' .**, hard. source 
F80A - Not to be reproduced 



pds . cds 



pdsp 


ptr ; 


1 pels 


aligned based (pdsp), 


2 


page_f aul t_data 


1 1ke mc. 


2 


fim_data 


1 1ke mc. 


2 


s1gna1_data 


al Igned 1 1ke mc. 


2 


h 1 3 1 or y_r eg_da t a 


(64) fixed bin (71). 


2 


process_group_1d 


char (32). 


i 


cpu_t Ime 


fixed bin (52). 




virtual delta 


fixed bin (52). 


£■ 


virtual time at eligibility 






fixed bin (52). 


J, 


temp_1 


fixed bin (71). 


J. 


temp 2 


fixed bin (71), 


Z 


t1me_1 


' fixed bin (52), 


2 


t 1me_v_temp 


fixed bin (52). 


2 


f1m_v_temp 


fixed bin (52). 


JL 


f 1m_v_del ta 


fixed bin (71). 


J. 


save_h1story_regs 


bit (1) aligned. 




hregs_saved 


bit (1) aligned. 


*> 


last_sp 


ptr. 




apt_ptr 


ptr. 


2 


arg_1 


fixed bin (71). 


JL 


arg_2 


fixed bin (71). 


t 
2. 


arg~3 


fixed bin (71), 


J, 


arg_4 


fixed bin (71), 


JL 


access_author izatlon aligned 1 1ke a1m_temp1at 


J. 


ba s e_a ddr_r eg 


bit (18) aligned, 


■JL 


a 1 arm_r i ng 


fixed bin (3). 


JL 


pxss_args_1nva1 Id 


bit (36) al Igned, 


n 
i 


process 1d 


bit (0) unaligned. 


2 


process_1d 


bit (36) aligned. 


t 
JL 


vt f me_count 


fixed bin. 


JL 


pstep" 


bit (0) unal Igned, 


2 


dstep 


bit (18) aligned, 


2 


wakeup_f lag 


bit (36) aligned. 


2 


pc_calT 


bit (36) aligned. 


2 


audi t_f lags* 


bit (36) aligned, 


2 


quota_lnh1b 


bit (36) aligned. 


X 


pd_page_f aul ts 


fixed bin. 


2 


page_wa1ts 


fixed bin. 


2 


number_of _pages_1 n_ 


use 






fixed bin. 


2 


post_purged 


f Ixed bin. 


2 


connec t_pend 1 ng 


bit (1) aligned. 


2 


segment_f aul ts 


fixed bin (35). 


2 


bounds_f aul ts 


fixed bin (35). 


2 


vtoc_reads 


fixed bin (35). 


2 


vtoc_wr 1 tes 


fixed bin (35). 


2 


mc_trace_seg 


fixed bin. 


2 


mc_trace_sw 


bit (2) aligned. 
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/* MC for page faults and timer runouts */ 

/* MC for normal faults +/ 

/* storage for MC being signalled +/ 

/+ this must follow signal data +/ 

/* user Id for current process */ 

/* number that when subtracted from clock reading gives 

virtual cpu time */ 
/* temporary used In calculating VCPU time */ 

/* temporary used In calculation of VCPU time +/ 

/* temporary */ 

/* temporary +/ . 

/* page fault metering time +/ 

/* temporary used 1n calculating VCPU time */ 

/+ VCPU temporary for the FIM */ 

/* VCPU temporary for the FIM */ 

/* - "1"b If history registers are to be saved */ 

/♦ m »t»b If history regs were saved */ 

/* Btack polinter at getwork time */ 

/+ pointer l:o this process's APT entry +/ 

/* argument for pxss */ 

/* argument for pxss */ 

/+ argument for pxss +/ 

/* argument for pxss */ 
», 

/* access authorization for the process */ 

/* for BAR mode use */ 

/* setting (For ring alarm register */ 

/* used by pxss masklng/arg copying code */ 

/* process CD (added s.egdef) */ 

/* process ID */ 

/* depth counter used In VCPU calculation +/ 

/* (added sogdef for dstep) */ 

/* rel pointer to ASTE for dseg */ 

/+ flag indicating type of wakeup */ 

/* flag saying type of wait */ 

/* bits Indicating types of auditing to do */ 

/* ON If quota checking to be Inhibited */ 

/* faults from paging device */ 

/* page faults +/ 

/* used In calculating memory units */ 

/* number of post purglngs */ 

/* turned on for delayed connects to be resent by flm */ 

/* count of segment faults taken by this process */ 

/* count of bounds faults taken by this process */ 

/* vtoc read I/Os done for this process */ 

/* vtoc write I/Os done for this process */ 

/* seg number of object segment being traced */ 

/* switch for M. C. Tracing " 1 1 "b => trace on */ 
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2 stack_0_sdwp 

2 stack_0_ptr 

2 tc_argp 

2 tc_mask 

2 expundf Irest 

2 exp_ovlf l_rest 

2 eovfl_value 

2 cparerrdata 

2 cpa r_mem_da t a 

2 cpar_1nfo 

2 hfp exponent enab 

2 padf ort f acemod 

2 trace 



ptr al igned. 
ptr al igned, 
ptr , 

bit (72) al igned. 
bit ( 1 ) al igned, 
bit ( t ) al igned. 
bit (72) aligned, 
bit (72) al igned. 
bit (72) al igned. 
bit (36) al igned. 
led bit ( 1 ) al igned. 
16 (14) fixed bin. 



2 t 1mer_t 1me_out 
2 t imerjchannel 
2 termchannel 
2 termproc 
2 pi 1_raach1ne 
2 val idat lonlevel 
2 cond 1 1 i on_name 

3 len 

3 chars 
2 pad_obsolete 
2 i ps mask 
2 auto_mask 
2 r \ ng_a 1 arm_va ) 
2 lock_1d 
2 mc_trace_buf 
2 pad_end_of_page_0 
2 pathname_am 
2 Ini t 1al_procedure 
2 account_1d 
2 lock_array 
2 access name 

3 user 

3 project 

3 tag 
2 home d 1 r 
2 process_d1r_name 
2 wdir 
2 wd1r_u1d 
2 transparent 
2 I tt head 
2 max access author 



2 stacks 
2 kstp 

2 events_pending 
2 spec ial_channel s 
2 event_masks 
2 Initialling 
2 interrupt_r ing 
2 highest_r ing 



(306) fixed bin (71 ), 

fixed bin (52). 
fixed bin (71). 
fixed bin (71). 
bit (36) al igned. 
f 1 xed bin, 
fixed bin (3), 
a 1 1 gned . 

fixed bin (8) unaligned 
char (31) unaligned, 
bit (36) al igned. 
(0:7) bit (35) al igned. 
(0:7) bit (36) al igned. 
(0:7) fixed bin, 
bit (36) aligned, 
ptr unal igned, 
bit (0) unal Igned, 
al Igned 1 ike pam, 
ptr , 

char ( 32 ) al Igned, 
(0:19) aligned like pds_ 
a 1 1 gned , 

char (32) al Igned, 
char (32) aligned, 
char (32) aligned, 
char (168) aligned, 
char (32 ) al Igned, 
(0:7) ptr. 

(0:7) bit (36) al Igned, 
bit (36) al Igned. 
bit (18) al Igned. 
ization 

aligned like a im_templ at 



/* ptr to stack sdw in dseg */ 

/* ptr to base of ring O stack (wired for esd) +/ 
/♦ arg ptr used by tc */ 
/♦ save tc mask ♦/ 

/+ switch for restart ing. exp underflows from the. f 1m +/ 

/* switch for restarting exp overflows from the fim +/ 

/* value to load. when restarting exp overflows from the fim * / 

/+ cache parity error data (from cache) */ 

/♦ cache parity error data (from memory) */ 

/* diagnose flag, cache level and absaddr tt */ 

/* user allowed to set IR hex exp bit +/ 

/♦ system trace data +/ 

/* pds$ trace + 16 defines the pds for idle procs */ 

/* time out time for the process */ 

/* event channel for time out event */ 

/* channel used to signal process termination +/ 

/+ process ID of process to signal term process */ 

/♦ nonzero If we do pi 1-1 ike things */ 

/* ACC string for condition name */ 



/♦ IPS masks ♦/ 

/* array of automatic masks for IPS signals */ 
/* used 1n checking validation level changes */ 
/* UID used in some locking +/ 
/■* packed ptr to mc_trace wired buffer */ 

/* pathname associative memory */ 
/* first procedure executed in a new process */ 
/* not used yet ♦/ 
entry, 

/* alternate form of process group id */ 



/* home directory */ 

/* name of process directory */ 

/* pointers to per-rlng working directories */ 

/♦ UID of per-ring working directories +/ 

/+ transparent usage, mod, pd switch */ 

/* top of present ITT list */ 



(0:7) ptr, 
ptr , 

bit (36) al igned. 
bit (36) al Igned. 
(7) bit (36) al Igned. 
fixed bin (3). 
fixed bin (3). 
fixed bin (3). 



e, 

/* max authorization this user can attain */ 

/* per-ring stack pointers +/ 

/* pointer to start of -KST */ 

/* special wakeups -pending +/ 

/* special channels assigned */ 

/* per-ring mask for special channels */ 

/* initial ring of execution for the process •/ 

/* lowest ring in which IPS interrupts are allowed */ 

/* highest ring in which process can run */ 
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2 prel 1nked_r ing 

2 un1que_scu_ index 

2 max_lot_size 

2 1ot_stack_s1ze 

2 c 1 r_stack_s 1 ze 

2 network_ptb l_1dx 

2 1 1nk_meters_b I ns 

2 1 1nk_meters_'t imes 

2 1 lnk_meters_pgwa Its 

2 dmpr_copy_dTrsegp 

2 dmpr~pv1d~" 

2 dmpr pvtx 

2 f irst_ca1 1 

2 mc_save_area 

2 mc_save_ptr 

2 mc_save_l im 1 1 

2 useable_lot 

2 rlng_events 

2 force_write_l imlt (O 



bit (8) aligned, 
bit (36) al Igned, 
(0:7) fixed bin. 
(0:7) fixed bin. 
(0:7) fixed bin, 
fixed bin, 
(4) fixed bin, 
(4) fixed bin (30) 
(4) fixed bin. 
ptr . 

bit (36), 
fixed bin, 
fixed bin, 
bit (18) al Igned. 
bit (18) aligned, 
bit (18) al Igned. 
bit (8) aligned, 
bit (36) al Igned. 
7) 

fixed bin. 



2 1pc_vars 
3 ap 
3 retsw 

3 save_entry_ret 
3 truncated_s tacks 
3 chan 

3 b1ock_start_steps 

3 stk_temp 
2 1pc_b1ock_return 
2 avg_bl ock_steps 
2 block_1ock_count 
2 pad_f or_da t a_mod 1 6 
2 data 

% Include pathname_am; 

% Include exponent~control_1nf o; 

% Include lock_array; 



al Igned, 
pointer unal , 
fixed bin (35). 
fixed bin (35). 
fixed bin (35). 
fixed bin (71). 
fixed bin (35). 
fixed bin (35). 
bit (36). 

fixed bin (35, 18), 
fixed bin. 

(13) fixed bin (35), 
bit (0) aligned; 



1 nc 1 ude * . hard . source 
F804 jot to be reproduced 



pds . cds 



/* b1t( 1 ) is ON If ring ( I ) is prel Inked +/ 

/* used to teg MC */ 

/* sizes lots can grow to */ 

/* size of let in stack (0 -> lot not In stack) */ 

/* size of CLR In stack */ 

/* Index into NCP's process table */ 

/* histograms of linkage faults */ 

/* histogram of linkage fault times +/ 

/* histogram of linkage faults PF's */ 

/* ptr to temp segment Into which dlrs are copied */ 

/* pvid of volume being dumped */ 

/* pvtx of volume being dumped */ 

/* ON until leave ring zero once */ 

/* rel pointer to start of saved MC area +/ 

/* ptr to next mc save place */ 

/+ max addres>s where MC can be saved + / 

/* Indicates whether lot can be referenced */ 

/* per-ring Indicator that Itt messages copied to ect */ 

/* limit on iorce-wr 1 t Ing */ 

/+ Following must be doubleword aligned! */ 

/* holds state of fast_hc_1pc at block */ 



/* ipc block return address */ 

/* count of locks held ♦/ 

/* to mark end of PDS for MC save area */ 
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call get_temp_segment_ ("pds" , pdsp. code); 

/* Now begins the Initialization */ 

pds .process_group_1d = " In! 1 la I izer . SysDaemon. z" ; 

pds . access_author izat ion. categor ies = (18)"0"b; 
pds . access_author Izat Ion. level ■ 0; 

pds . accessauthor Izat ion. dir » "1"b; /♦ for Initializer ♦/ 

pds.access_author1zation.seg ■ "l"b; 
pds . accessauthor Izat Ion. rep * M i"b; 
pds „ accessauthor Izat Ion. ipc * " 1"b; 

pds . accessauthor Izat Ion. soos * "l H b; /* .. */ 

pds. max_access_author Izat ion. categories = (18)"1"b jj (I8)"0"b; 
pds.max_access_author izat ion. level =7; 

pds . vt lme_count = -1; 

pds.process_1d = (36)" 1"b; 

pds.lock_id = (36) H l"b; 

pds . pi Imachine * I; 

pds. ips_n\ask (*) * (35)"!"b; 

pds . f orce wr itej im i t (*) = 1 ; 

pds. save_hlstory_regs, pds . hregs_saved = "0"b; 
pds . hlstory_reg_data ( * ) =» O; 

pds . mc_trace_buf ■ null; 
pds . mc_trace_sw ■ "0"b; 
pds . met raceseg = O ; 

pds . eovf l_yalue » unspec (Def aul t_exponent_control_overf low_value) ; 

/* set default exp overflow restart value */ 

pds . exp_ovf l_rest , pds . exp_undf l_rest = "0"b; 

pds « stack Osdwp = null; 

pds . stack Opt r « null; 

pds . pad_f or_trace_mod 16 (+) = O; 

trace_ptr = addr (pds. trace); 

trace. 1ast_avai table - divide (hbound (pds. trace, 1) * size ( page_trace_ent ry ) - 8„ 2, 17, 0); 

pds . ini t ial_procedure = null; 
pds . lock_array (*).lock_ptr ■ null; 
pds . 1ock_array ( * ) .cal ler_ptr = nul 1 ; 
pds . lock_array (*). event = ""b; 



pds . accessname . user = "Initializer"; 
pds. access_name. project = "SysDaemon"; 
pds . accessname . tag = "z"; 

pds.home_dir = ">system_control_1 " ; 

pds .process_dir_name = ">process_dir_dir> I zzzzzzzbBBBBBB" ; 
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pds.wdir (*) ■ null; 
pels. wdl r_u Id (*) » "0"b; 



pds. stacks (*) ■ null; 

pds.dmpr_pv1d ■ H 0"b; 

pds . dmprpvtx - O ; 

pds . dmpr_copy_d 1 rsegp * null ; 

pds . kstp « nul 1 ; 
pds. f 1rst__cal1 « 1; 
pds . Ini t ta1_r Ing ■ 1; 
pds. inter rupt_r1ng * 4; 
pds.h1ghest_r tng -7; 

pds.max_lot_s1ze (+) • 1024; 

pds . mc_save_area - rel (addr (pds.data)); 
pds.mc_save_ptr ■ rel (addr (pds.data)); 

pds.mc_save_1 1ml 1 - bit (bin (4096, 18), 18); /* Allow for as many as fit In 4K. */ 

/* Now make some checks on alignment of certain variables */ 

call check (addr (pds . 1pc_vars ) , M 1pc vara", 2); 

call check (addr (pds .page_f aul t_dataT. "pagef aul tdata" . 16); 

call check (addr (pds. trace), "trace", 16); 

call check (addr (pds . signa!_data) , "s1gna!_data" , 16); 

call check (addr (pds. 1ock_array) , " lock_array" , 2); 

call check (addr (pds.data), "data", 16); 

If bin (rel (addr (pds.pad_end_of_page_0) ) , 18) 1024 

then call com_err_ (0, pdsname, "Wired portion must end. at 1024"); 

/* Now set up call to create data base */ 

cdsa. sect Ions (1).p ■ addr (pds); 
cdsa. sections (1).1en ■ size (pds); 
cdsa. sect ions ( 1 ) . struct_name ■ "pds"; 

cdsa . segname ■ "pds"; 
cdsa.num_exdude_names ■ 1; 

cdsa.excTude_array_ptr ■ addr (exc1ude_pad) ; 

string (cdsa. swl tches) ■ "0"b: 
cdsa.switches.have_text ■ "1"b; 

call create_data_segment_ (addr (cdsa), code); 

call release_temp_segment_ ("pds", pdsp, code); 

call hcs_$chnamo_f 1 1 e (get_wdir_ (), "pds", "", "template_pds" , code); 
If code /s * 0 

then if code error_tab1e_$segnamedup 
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then call com_err_ (code, pdsname, "Unable to add name tempi a te_pds . " ) ; 
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check : 

proc (where, message, modulo); 



del where ptr; 

del message .char (*); 

del modulo fixed bin; 

del remainder fixed bin; 



remainder - mod (bin (rel (where), 18), modulo); 
If remainder A » 0 

then call com_err_ (O, pdsname, "The variable ~a Is ~d words away from being aligned on a ~d-word boundary.", 
message, (modulo - remainder), modulo); 

end check; 
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% Include cdsargs; 
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% include sys_trace; 
% Include a1m_temp1ate; 
^Include roc; 

end pds; 
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segment In: > 1 dd>hard>source 

contents modified: 07/29/81 18 16.2 



system Id: 36-1 
entry modi f led: 03/27/83 1807.1 



/+ PRDS - The Processor Data Segment and Processor Stack. 
/ + Last modified (Date and reason): 
2/6/76 by S. Webber Initial coding 

6/15/77 by M . Weaver to null signal and set pointers 
8/2S/80 by J. A. Bush for the dps8/70m cpu 
2/22/81 by J. Bonglovannl for f ast_connect_code 
6/27/81 by J. Bonglovannl for 1dle_temp 

*/ 



* * 

* Copyright (c) 1972 by Massachusetts Institute of + 

* Technology and Honeywell Information Systems, Inc. * 

* * 

* + 



prds: proc; 

/* This program creates the prds data base */ 

/* Automat 1c */ 

del i fixed bin; 

del 1 cdsa aligned like cds_args; 

del code fixed bin (35); 

/* Static */ 

del prdsname char (4) aligned static init ("prds") options (constant); 

del excludepad (1) char (32) aligned static options (constant) Init ("pad*"); 

/* The following must correspond to the size of the fast connect code In 

f ast_connect_1ni t */ 

del FAST_C0MNECT_C0DE_W0RDS 1n1t %62) fixed bin int static options (constant); 

/* Builtins */ 

del (addr, baseptr, bin, mod, null, ptr, rel, size, string, unspec) butltin; 
/* Entries */ 

del com_err_ entry options (variable); 

del create_data_segment_ entry (ptr, fixed bin (35)); 

del get_temp_segment_ entry (char (*), ptr, fixed bin (35)); 
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del re1ease_temp_segment_ entry (char (*), ptr, fixed bin (35))-; 
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del prdsp ptr; 



del 1 prds aligned based (prdsp), 

2 header aligned like stackheader, 

2 interrupt_data aligned like mc, 

2 fim_data aligned like mc, 

2 sys_trouble_data aligned like mc, 

2 ignore_data aligned like scu, 

2 i i temp f ixed bin (71 ) . 

2 last_recorded_t Ime fixed bin (71), 

2 idleptr ptr, 

2 s imulated_mask fixed bin (71), 
2 am_data bit (O), 

2 ptwam regs (4*16) fixed bin (35), 

2 ptw_am_ptrs (4*16) fixed bin (35), 

2 sdwam'regs (4*16) fixed bin (71), 

2 sdwam~ptrs (4*16) fixed bin (35), 

2 processorpattern bit (8) aligned, 

2 processortag fixed bin (3), 

2 last_t Imer_set1t Ing bi t (27) aligned. 

2 depth f ixed bin, 

2 modereg bit (36) aligned, 

2 cache) ufreg bit (36) aligned, 

2 fault_reg bit (72) aligned. 

2 aptptr ptr, 

2 id1e_temp fixed bin (71), 



/* The following contains code used for handling connect 



2 f astconnectcode ( FAST_CONNECT_CODE_WORDS ) bit (36) 

2 f ast_connect_code_end bit (36) aligned, 

2 raoderegenab 1 ed bit (36) aligned, 

2 pad_mod_16 (3) fixed bin, 

2 processor_stack aligned like stack_frame; 



/* standard stack header ♦/ 

/* MC for Interrupts */ 

/* MC for connect faults, timer runouts */ 

/♦ MC for saved sys trouble data */ 

/* for SCU data to be ignored at certain times */ 

/* temporary used by 11 (surprise I) */ 

/♦ used by traffic control +/ 

/♦ pointer to idle process APTE for this processor */ 

/* simulated system controller mask register +/ 

/* to get addr of associative memory data block */ 

/♦ page table regs (4 sets of 16 for dps8/70m) */ 

/♦ page table pointers (4 sets of 16 for dps8/70m) */ 

/* segment desc. regs (4 sets of 16 for dps8/70m) */ 

/♦ segment desc. pointers (4 sets of 16 for dps8/70m) 

/* 1 bit ON for this processor */ 

/* CPU tag from maintenance panel */ 

/♦ last timer value loaded for this CPU */ 

/+ depth in eligible queue for running process +/ 

/■* mode register for this processor */ 

/* cache mode register for this CPU */ 

/* place to store the fault register */ 

/+ -> apte running on this cpu */ 

/* used by idle process +/ 

faults for this processor */ 



al igned, 

/+ marker for f ast_connect_in1 t */ 
/* used to set mode register */ 

/* first stack frame location */ 
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call get_temp_segment_ ("prds", prdsp, code); 
unspec (prds) ■ ""b; 



/* Now make some checks on alignment of certain variables ♦/ 

call check (addr (prds. 1d1e_ptr ) , "1dle_ptr". 2); 

call check (addr ( prds. processor_s tack). "processor_stack" , 16); 

call check (addr (prds.ptw_am_.regs) , "ptw_am_regs" , 16); 

call check (addr ( prds . sdw_am_regs ) , "sdw_am_regs" , 32); 

call check (addr (prds. f ast_connect_code) , "f ast_connect_code" , 2); 



/* Now set up call to create data base */ 

cdsa. sect Ions (1).p - addr (prds); 
cdsa. sections (1).len * size (prds); 
cdsa. sect Ions ( 1 ) . struct_name - "prds"; 

cdsa . seg_name ■ "prds"; 
cdsa . num_exc 1 ude_namea > 1; 
cdsa.exclude_array_ptr ■ addr ( exc 1 ude_pad ) ; 

string (cdsa. switches) ■ "0"b; 
cdsa. switches. have_text » "1"b; 

call create_data_segment_ (addr (cdsa), code); 

call re1ease_temp_segment_ ("prds", prdsp, code); 
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check: proc (where, message, modulo); 

del where ptr; 

del message char ( * ) ; 

del modulo fixed bin; 

if mod (bin (rel (where), 18), modulo) ~= O 

then call com_err_ (0, prdsname, "The variable "a is not aligned on a ~d-word boundary.", message, modulo); 
end check s 



inc. » . * * , hard, source 
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prds . cds 



ge 68 



% Include cds_ args ; 
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% Include stack_header ; 
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% Include stack_frame; 
% include mc; 

end prds; 
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ptw. 168. incl .pi 1 



segment In: >1dd>include contents modified: 07/29/81 1747.9 

entry modified: 03/10/82 0836.9 



/* BEGIN INCLUDE FILE ... ptw. 168. Incl .pi 1 ... 02/26/81, f 
/* Note: This include file has an ALM counterpart made wit 

del I l68_core_ptw aligned based (ptp), 

2 frame fixed bin (14) unsigned unaligned, 

2 padl bit (4) unaligned, 

2 flags unaligned like 168_ptw_f lags ; 

del 1 168 ptw aligned based (ptp), 
2 add bit (18) unaligned, 
2 flags like 168_ptw_f lags unaligned; 

del 1 168_special_ptw aligned based (ptp) like 168_ptw; 
del 1 168_real_disk_ptw aligned based (ptp) like 168 ptw; 
del 1 168_nul l_disk_ptw aligned based (ptp) like 168_ptw; 

del 1 168_ptw_f lags unaligned based, 
(2 add_type bit (4). 
2 first bit ( 1), 
2 er bit ( 1 ). 

2 padl bit ( 1 ) , 

2 unusable 1 bit (1). 

2 phu bit ( 1 ) . 

2 phm 1 bit ( 1 ) , 
2 nypd bit ( 1). 
2 phm bit ( t). 

2 phu 1 b 1 1 (' 1 ) , 

2 wired bit ( 1 ) , 

2 os bit ( 1 ) , 

2 val id bit ( 1 ) , 

2 df_no bit (2)) unaligned; 

/* END INCLUDE FILE ... ptw. 168 . incl .pi 1 ♦/ 



ADP conversion */ 
cif . Keep it up to. date ♦ / 

/* In-core page descriptor */ 
/♦ Core frame number */ 



/* Genera) declaration for out-of-core PTW */ 



/♦ Page is somewhere peculiar -- add_type » H 01 M b */ 
/* PTW for page actually on disk -- add_type - " 10"b ♦/ 
/* PTW for page not yet on disk -- add_type ■ M 1 1 "b */ 

/* Various software/hardware flags */ 

/* 0000=null. 1000=core, 0100=d1sk, 0010=pd. 0001*swap */ 
/* the page has not yet been written out +/ 

/* error on last page I/O (also used by post-purge as temp) */ 



/* can't be used because hardware resets this bit */ 
/* page has been used bit */ 

/* Cumulative OR of hardware phm's */ 
/* must be moved to paging device */ 
/* page has been modified bit */ 

/* page has been used in the quantum */ 

/* page is to remain in core */ 

/* page is out-of -service (I/O In progress) */ 

/+ directed fault if this is 0 (page not in core) */ 

/* directed fault number for. page faults */ 



include.**, hard. source 
F80A - Not to be reproduced 



ptw. 168. incl .pi 1 



Page 72 



pv_ho1dt . Incl .pit segment In: >1dd> Include contents modified: 05/13/76 1025.4 

entry modified: 03/10/82 0836.5 

/* BEGIN INCLUDE FILE ... pv_holdt . Incl .pi 1 . . . */ 

del pv_holdtp ptr; 

del 1 pv_holdt (1 : 64) based (pv_holdtp) aligned. 

2 pvtx fixed b1n(17) unaligned, 
2 apterp b1t(18) unaligned; 

/* END INCLUDE FILE ... pv_holdt . Incl .pi 1 . . . */ 
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pvt . incl .pi 1 



segment in: >ldd> include contents modified: 05/20/82 1037.6 

entry modified: 05/20/82 1047.6 



/* 



BEGIN INCLUDE FILE 



pv t . 1 nc I . p I 1 



last modified January 1982 */ 



/* The physical volume table (PVT) is a wired-down table. 
It has one entry for each spindle present, be it for 
Storage System or "I/Q w use. 

♦/ 



del 



pvt$ 
pvtp 



ex t , 
ptr; 



del 



1 pvt 



2 n_entries 
2 max_n_entr les 
2 n_1n_use 
2 rwun_pvtx 
2 shutdown_state 
2 esd_state 
2 prev_shutdown_state fixed bin, 
2 prev_esd_state fixed bin. 



based (pvtp) aligned, 

f ixed bin ( 17) , 
fixed bin ( 17) , 
fixed bin ( 17), 
fixed bin. 
f ixed bin. 
f ixed bin. 



2 t ime_of_bootload fixed bin (71). 



2 root_lvid 

2 root_pvid 

2 root_pvtx 

2 root_vtocx 

2 disk_table_vtocx 

2 disk table uid 



bit (36) al igned. 
bit (36) al igned, 
fixed bin, 
fixed bin. 
fixed bin, 
bit (36) al Igned, 



/* number of PVT entries */ 

/* max number of PVT entries */ 

/* number of PVT entries in use */ 

/* rewind_un loading pvtx +/ 

/♦ state of previous shutdown */' 

/* state of ESO, >0 iff in ESD */ 

/* shutdown state of previous boot load */ 

/* ESO state of previous boot load */ 

/* Time of boot load */ 

/* Logical volume ID of Root Logical Volume (RLV) */ 

/* Physical volume ID of Root Physical Volume (RPV) */ 

/* Index to PVTE for Root Physical Volume (RPV) */ 

/♦ VTOCE index for root (>) */ 

/* VTOCE index for disk table on RPV */ 

/* File System UID for disk_table */ 



rpvs_requested bit (t) aligned, /♦ 

rpv_needs_sal v bit (1) aligned, /* 

r I v_needs_salv bit (1) aligned, /* 

volmap_lock_wai t_constant bit (36) aligned./* 
volmap_1d1e_wa i t_constant bit (36) aligned./'*' 



vtoc_map_lock_wa1 t_constant bit (36) 
n_volmap_locks_held fixed bin (17). 
n_vtoc_map_locks_held fixed bin (17), 



al igned, 
/* 
/* 



2 last_volmap_t ime fixed bin (71), 

2 last_vtoc_map_t ime fixed bin (71), 

2 total_volmap_1ock_t ime fixed bin (71), 

2 total_vtoc__map_lock_t ime fixed bin (71) 

2 n_vo 1 map_ I ock s fixed bin (35), 

2 n_vtoc_imap_l ocks fixed bin (35), 

2 volmap_lock_nowa i t_cal 1 s fixed bin (35) 

2 volmap_lock_nowa1 t_f a i 1 s fixed bin (35) 



RPVS keyword given on BOOT */ 

RPV required (not requested) salvage */ 

RLV required (not requested) salvage ♦/ 

For constructing wait event: OR pvte_rel into lower +/ 

For constructing wait event: OR pvte_rel into lower */ 

/* For constructing wait event: OR pvte_rel into lower */ 

Current number of vol map locks held */ 

Current number of VTOC Map locks held */ 



/* Time a volmap was last locked/unlocked */ 

/+ Time a VTOC Map was last locked/unlocked */ 

/* Total time volmap's were locked (integral) */ 

/* Total time VTOC Maps were locked (integral) */ 

/* Number times a volmap was locked */ 

/* Number times a vtoc_map was locked */ 

/+ Number calls to lock volmap. no wait */ 

/* Number times lock failed +/ 
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2 vo1map_1ock_wa1t_ca1 Is fixed bin (35), /* Number calls to lock volmap, wait */ 

2 vo1map_lock_wait_fa1 Is fixed bin (35), /* Number times lock failed */ 
2 pad (2) bit (36) aligned. 

2 array fixed bin (71); /* Array of PVTE's -- must be double-word aligned */ 



/♦ END INCLUDE FILE . . .pvt . Incl . pi 1 */ 
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pvte. incl .pi 1 



segment in: >ldd> Include contents modified: 10/ 13/82 1310.8 

entry modified: 10/13/82 1311.9 



/♦ START OF: pvte. incl .pi 1 duly 1982 ♦ * */ 

del pvt$array aligned external; 

del pvt$max_n_entr les fixed bin external; 



del pvt_arrayp ptr; 

del pvtep ptr; 

del 1 pvt_array (pvt$max_n_entr les ) aligned 1 ike pvte based (pvt_arrayp) ; 



del 1 pvte 

2 pvid 
2 lvid 

2 dmpr_in_use 
2 pad3 

2 sk lp_queue_count 
e to saturation */ 

2 brother_pvtx 



based (pvtep) aligned, 

bit (36), / + physical volume ID */ 

bit (36), /* logical volume ID */ 

(3) bit (1) unaligned, /* physical volume dumper Interlock +/ 
bit (6) unal igned, 

fixed bin (18) unsigned unaligned, /* number of times this pv skipped for per-proc allocation du 

fixed bin (8) unaligned./* next pvte in lv chain */ 



2 devname 



ger table */ 



char (4), 

f ixed bin (8) . 



logical_area_number fixed bin (8) 
used bit 
storage_system bit 
permanent bit 
testing bit 
beingmounted bit 
be i ng_demoun ted bit 
check_read_ incomplete bit (1), 
devlce_inoperat 1 ve bit 
rpv bit 
scav check address 



2 depos i t_to_volmap 

2 being_demounted2 

2 pad5 

2 vacating 

2 hc_part_used 



bit 

bit 
bit 
bit 
bit 
bit 



/* device name */ 

/+ device type */ 

/+ disk drive number */ 

/* TRUE if this entry is used */ 

/* TRUE for storage system (vs io disk) */ 

/* TRUE If cannot be demounted */ 

/* Protocol bit for read_d1sk$test +/ 

/* TRUE if the physical volume is being mounted */ 

/* TRUE If the pysical volume is being demounted */ 

/* page control should check read incomplete */ 

/* TRUE if disk_control decides dev busted ♦/ 

/* TRUE If this is the root physical volume */ 

/+ TRUE Is page control should check deposits/withdrawals against scaven 

/* TRUE If deposits should got to volume map, not stock */ 
/♦No more vtoc I/O during demount */ 

/+ don't put new segs on this vol */ 
/* HC part set up by initpvt */ 
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2 volmap_1ock_not ify bit (1) unal. 
2 volmap_1dle_not if y bit (1) unal, 
2 vtoc_map_lock_notify bit (1) unal. 



/* TRUE if notify required when volmap lock is unlocked */ 

/* TRUE if notify required when volmap state is idle */ 

/* TRUE if notify required when vtoc map lock is unlocked */ 



2 


n_f ree_vtoce 


fixed bin ( i7) . /* 


number of free VTOC entries +/ 


2 


vtoc_size 


f Ixed bin ( 17 ) . /* 


size of the VTOC part of the disk - 


2 


dbmrp 


(2) bit ( 18). /* 


rel ptr to dumber bit maps for this 


2 


nlef t 


fixed bin ( 17) , /* 


number of records left */ 


2 


totrec 


fixed bin (17)) unaligned. 


/* Total records in this map */ 


2 


dim_info 


bit (36). /* 


Information peculiar to DIM */ 


2 


curn_dmpr_vtocx 


(3) fixed bin unaligned./* 


current vtocx being dumped */ 


2 


n_vtoce 


fixed bin unaligned, /* 


number of vtoce on this volume */ 


2 


baseadd 


fixed bin (18) uns unaligned. / + Base of paging region */ 


2 


pad2 


bit (18) unal 1gned. 




2 


vo 1 map_seg_sdw 


fixed bin (71), /♦ 


SDW describing volmapseg +/ 



2 volmap_astep 

2 vo1map_of f set 
2 vtoc_map_of f set 



ptr unal , 

bit (18) unal. 
bit ( 18) unal , 



/* Packed pointer to ASTE for vo1map_seg */ 

/* Offset in volmap_seg of volume map */ 
/* Offset in vo1map_seg of VTOC map */ 



2 vo1map_lock 
2 vtoc_map_1ock 
2 volmap_stock_ptr 



bit (36) aligned, 
bit (36) al igned. 
ptr unal , 



2 vtoc_map_stock_ptr ptr unal 



/* Lock on volume map operations */ 
/* Lock on VTOC map operations ♦/ 
/* Packed pointer to record stock */ 
/* Packed pointer to VTOCE stock */ 



2 volmap_async_state fixed bin (17) unaligned, /* Asynchronous update state of Volume Map */ 
2 vo1map_async_page fixed bin (17) unaligned, /* Page number for asynchronous update */ 

2 vol_trouble_count fixed bin (17) unaligned, /* Count of inconsistencies since last salvage */ 
2 scavenger_b1ock_rel bit (18) unaligned; /* Offset to scavenger block, A 0 *> scavenging */ 



del (VOLMAP ASYNC IOLE 

VOLMAP_ASYNC_READ 
VOLMAP ASYNC WRITE 



Init (0), /* for volmap_async_state */ 

Init (1). 

init (2)) fixed bin int static options (constant); 



/* END OF 
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rnt.1ncl.pJ1 segment in: > ldd> inc hide contents modified: 12/16/77 1314.1 

entry modified: 03/10/82 0836.6 



/♦ BEGIN INCLUDE FILE RNT . INCL . PL 1 - WRITTEN SEPTEMBER 1974 BY R. BRATT ♦ / 

/* modified July 1976 by R. Bratt; updated March 1977 by M. Weaver ♦/ 

/* modified November 1977 by M. Weaver to use PL/I offsets Instead of pointers +/ 

del (rntp, rntep) ptr; 

del 1 th f ixed bin ( 17) ; 

del based_rnt_area area based; 

del 1 rnt aligned based (rntp), 

2 areap ptr, /♦ pointer to area for rnte allocations */ 

2 meters, 
3 Insert. 

4 trys fixed bin (17) unaligned, 
4 wins fixed bin (17) unaligned, 
3 getsegno like insert, 
3 get_ref names like insert. 
3 deletesegno like insert, 
3 delete_name like insert, 
2 rnt_area_s ize fixed bin, 
2 srulep ptr , 

2 name_hash_table (0:127) offset (rnt. areap -> based_rnt_area ) , 
2 segno_hash_table (0:127) offset ( rnt . areap -> based_rnt_area ) ; 

del 1 rnte aligned based (rntep), 

2 name_fp offset (rnt. areap -> based_rnt_area ) , 
2 segno_fp offset (rnt. areap -> based_rnt_area), 
(2 segno fixed bin (17), 
2 length fixed bin (17). 

2 name char (1th refer (rnte. length) ) )unal igned; 
/* --- - END RNT. INCL. PL 1 */ 
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scavenger_data. Incl.pU 



segment in: >1dd> Include contents modified: 11/19/82 1602.2 

entry modified: 11/19/82 1604.3 



/* START OF 

/* format: style3 */ 
del 



scavengerdata. incl .pi 1 November 19(12 



*/ 



del 
del 
del 
del 
del 
del 

del 
del 
del 



scavenger_data$ external ; 

scavenger_datap ptr; 

sc_metersp ptr; 

sc_process_tablep ptr; 

scavenger_b1ockp ptr; 

record_b1ockp ptr; 

scavenger_opt lonsp ptr; 

sc_n_processes fixed bin; 

scavenger_n_records fixed bin; 

scavenger_n_ovf 1 fixed bin; 



del 



scavengerdata 
2 lock 

3 1ock_word 

3 wait~event 

3 notl7y_sw 
2 process_table_ptr 

ptr, 

2 error_sever1ty 
2 meters 
2 free 



aligned based ( scavenger_da tap) . 



a 1 1 gned , 

bit (36) al 1gned. 
bit (36) aligned, 
bit (1) aligned. 



fixed bin. 

aligned like scmeters, 
bit (1) aligned; 



/* Lock on scavengerdata */ 



/* Pointer to scavenger process table */ 

/* Severity of unexpected error condition +/ 



/* Available region */ 



del 



scmeters aligned based (scmetersp) 

2 n_scavenge fixed bin (35), 

pf fixed bin (35), 

vcpu fixed bin (71). 

clocktime fixed bin (71), 

n_vtoces fixed bin (35). 



n_vtoces_damaged 



fixed bin (35). 



n_y toces_per_proc 
f 

n_vtoces_per_boot 
f 

n_vtoces_f reed f 
n_vtoces_fmd f 
n_records f 
n_conflicts f 
n_f md_conf 1 lets f 
n_rea1_conf 1 lets 

f 

n lost records f 



ixed bin (35). 

Ixed bin (35). 

ixed bin (35), 

ixed bin (35), 

ixed bin (35). 

Ixed bin (35), 

ixed bin (35), 

ixed bin (35), 

ixed bin (35); 



/* Meters */ 

/* Number of volume scavenges */ 

/+ Total page faults */ 

/* Total virtual CPU time */ 

/* Total clock time */ 

/* Number VTOCEs examined +/ 

/* Number VTOCEs damaged by scavenge */ 

/* Number per-process VTOCEs freed */ 

/* Number per-bootload VTOCEs freed */ 

/* Total number VTOCEs freed */ 

/+ Number VTOCEs with fm_damaged reset */ 

/* Number non-null filemap entries examined */ 

/* Number potential conflicts detected */ 

/* Number potential conflicts due to fmdamaged */ 

/* Number real conflicts */ 

/* Number lost records freed */ 
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del 



sc_process_table aligned based (sc_process_tablep) , 

2 max_n_processes fixed bin. /* Number of table entries */ 

2 n_processes fixed bin, /* Number active entries ♦/ 

2 process ( sc_n_processes refer ( sc_process_table.max_n_processes ) ) aligned, 

3 processld bit (36) aligned, /♦ Owner. 0=>empty */ 

3 pvtep ptr unal, /* PVTE of volume being scavenged */ 

3 blockp ptr unal, /* Block w/l scavenger_data */ 



f irst_block_page 

f i xed bin, 
n_block_pages fixed bin; 



/* Index of first page of block */ 
/♦ Number of pages in block */ 



del 



scavenger_block 

2 n_records 

2 n_ovfl 

2 ovfl_free_ix 

2 records 

2 overflow 



aligned based ( scavengerblockp) , 

fixed bin, /* Number of record addresses */ 

fixed bin, /* Number of overflow blocks */ 

fixed bin, /♦ Index of first free overflow block */ 

( scavenger_n_records refer ( scavenger_block . n_records ) ) aligned like record_block 

( scavenger_n_ovf 1 refer ( scavenger _block . n_ovf 1 j ) aligned like record_block ; 



del 



record_block 
2 vtocx 
2 pageno 
2 state 
2 lock 
2 ovflx 



aligned based ( record_blockp ) , /* One per record address */ 



fixed bin (15) uns unal 
fixed bin (8) uns unal, 
fixed bin (2) uns unal. 
bit (1) unal , 
fixed bin (10) uns unal 



/♦ 
/* 
/* 
/* 
/♦ 



Owning VTOCE index +/ 
Owning page number */ 
State */ 

Lock bit on this block 



*/ 



Index of first overflow block on chain */ 



del 



del 



1 scavenger_data_pages 

aligned based ( scavenger_datap) . 
2 page (0:255) aligned, 

3 word (1024) bit (36) aligned; 

1 scavenger_opt ions aligned based ( scavengeropt ionsp) , 



pr int_meters 
debug 
dump 
trap 

no_opt imlze 



bit 
bit 
bit 
bit 
bit 



(1) 
(1) 
(1) 
(1) 
(1) 



unal igned. 
una 1 i gned , 
unal igned, 
una 1 i gned . 
unal igned; 



/* 
/* 
/♦ 
/* 



OIM 
ON 
ON 
ON 
ON 



=> meter each scavenge into the log */ 

=> do special debugging things */ 

=> dump bad VTOCEs into syserr log */ 

=> trap to BOS for debug */ 

»> no VTOCE read-ahead */ 



del 



( 

STATE_UNSEEN 

STATE_FREE 

STATE_IN_USE 

STATE_CONFLICT 

) 



init (0). 
init (1). 
init (2). 
init (3) 
f ixed bin 



int static options (constant) 



/* END OF: scavenger_data . inc 1 . pi 1 + + + + 
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scs.incl.pll segment In: >ldd> include contents modified: 04/29/82 1127.6 

entry modified: 04/29/82 1136.4 



/* BEGIN INCLUDE FILE scs.incl.pll 



April 1982 */ 



/* Information about system controllers */ 

del 1 scs$control 1er_data (0:7) aligned ext. 
2 size fixed bTn (17) unaligned, 
2 base fixed bin (17) unaligned, 
2 eimadata (4) unaligned, 

3 maskavai labia bit (1) unaligned, 
3 maskass igned bit (1) unaligned. 
3 mbz bit (3) unaligned, 

3 maskass tgnment fixed bin (3) unaligned, 
2 Info al igned, 

3 online bit (1) unaligned, 
3 offline bit (1) unaligned, 
3 store_a_on1 ine bit (1) unaligned, 
3 store_a1_onl ine bit (1) unaligned, 
3 store_b_onl Ine bit (1) unaligned, 
3 store_b1_onl ine bit (1) unaligned, 
3 store_b_1s_1ower bit (1) unaligned. 
3 ex t_ inter laced bit (1) unaligned. 
3 int_inter laced bit (1) unaligned, 
3 four_word bit (1) unaligned, 
3 cycl ic_pr iority (7) bit (1) unaligned. 
3 type bit (4) unaligned, 
3 abs_wired bit (1) unaligned, 
3 program bit (1) unaligned, 
3 mbz bit (13) unaligned, 
2 lower_store_s1ze fixed bin (17) unaligned, 
2 upper_store_s1ze fixed bin (17) unaligned; 

/* Information about CPUs */ 

del 1 scs$processor data (0:7) aligned ext. 
( 

2 onl ine bit (1), 
2 of f 1 ine bit (1). 
2 re1ease_mask bit (1), 
2 acceptmask bit (1), 
2 deletecpu bit (1), 
2 1nterrupt_cpu bit (1), 
2 hal tedepu bit (1). 
2 cpu_type fixed bin (2) unsigned, 
2 mbz bit (21), 
2 expanded_port bit ( 1 ) , 
2 expander_port fixed bin (2) unsigned. 
2 control ler_port fixed bin (3) unsigned 



/* per-control ler info */ 

/* size (in 1024 word blocks) of this controller */ 

/+ abs address (0 mod 1024) for base of this controller */ 

/* E IMA Information for this controller */ 

/* ON If corresponding mask exists */ 

/* ON if mask assigned to a port */ 

/* port to which mask is assigned */ 

/* ON If controller Is online */ 

/* ON If controller Is offline but can be added */ 

/* ON If store A Is online +/ 

/+ ON If store Al 1s online */ 

/* ON if store B is online */ 

/+ ON If store B1 is online +/ 

/♦ ON if store B 'Is lower */ 

/* ON If this SCU is interlaced with other SCU */ 

/* ON If this SCU 1s Internally Interlaced */ 

/* ON If external interlace is 4-word */ 

/* Cyclic priority for adjacent ports */ 

/* Model number for this controller */ 

/* ON If controller can have abs_w1red pages */ 

/* PROGRAM/MANUAL switch setting"*/ 

/* size (In 1024 word blocks) of lower store */ 
/* size (In 1024 word blocks) of upper store */ 



/* Information about CPUs In the system */ 
/* "1"b If CPU Is online */ 

/* "l"b If CPU Is offline but can be added */ 

/* "1"b Is this CPU Is to give up Its mask */ 

/* "1"b If this CPU is to grap mask in idle loop +/ 

/* "1"b if this CPU Is to delete itself */ 

/* "1"b If this CPU takes hardware Interrupts */ 

/* "1"b If this CPU has stopped itself (going to BOS) */ 

/* 0 *> DPS or L68, 1 -> DPS8 */ 



) unal Igned; 



/* "1"b » on expanded port */ 
/+ The actual expander port +/ 

/+ Port on controller */ 
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del 1 scs$port_data (0:7) aligned external static, 
2 assigned fixed bin (4) unsigned unaligned, 
2 expander_port bit (1) unaligned, 
2 expanded_cpu (0:3) bit (1) unaligned, 
2 1om_number fixed bin (3) unsigned unaligned, 
2 cpu_number (0:3) fixed bin (3) unsigned unaligned, 



2 pad bit (12) unaligned; 



/* Info about what is connected to each SCU port */ 

/* Type of device on this port */ 

/* "i"b »> this port has a port expander ♦/ 

/» " i "to »=> this expander port has a CPU attached */ 

/* IOM number of IOM attached to this port */ 

/♦ CPU number of CPU(s) attached to this port */ 

/* cpu_number (0) is only one if expahder_port is "0"b 



del t 



Actual connect words */ 
Expander COW s must be odd-word */ 



/* Expander sub -port mask 
/* Expander command. */ 



*/ 



scs$cow (0:7) aligned external, /* 
2 pad bit (36) aligned, /♦ 
2 cow , 

3 submask bit (8) unaligned, 
mbzl bit (13) unaligned, 
expander_command bit (3) unaligned, 
mbz2 bit (2) unaligned. 

expanded_port bit (1) unaligned, /♦ 
expander_por t fixed bin (3) unsigned unaligned, /♦ 
mbz3 bit (3) unaligned. 

control ler_port fixed bin (3) unaligned unsigned;/* controller port for this CPU */ 



"1 M b = on expanded port */ 
Port on expander for cioc */ 



del 



del 



1 scs$cow_ptrs (0:7) external aligned, 
2 relcowptr bit (18) unal, 
2 pad bit (12) unal . 
2 tag bit (6) unal ; 



/* Pointers to COW's */ 

/* Relative pointer to COW */ 

/♦ Better be zero. */ 

/* Used during reconfig ops. */ 



1 scs$reconf ig_general_cow aligned external, 
2 pad bit (36) aligned, 
2 cow , 

3 sub mask bit (8) unaligned, 
3 mbzl bit (13) unaligned, 
3 expander_command bit (3) unaligned. 
3 mbz2 bit (9) unaligned, 

3 control I er_port fixed bin (3) unaligned unsigned;/* controller port for this CPU */ 



/* Connect operand word, in odd location. */ 
/* Expander sub-port mask */ 

/+ Expander command. *./ 



/* MASKS and PATTERNS */ 



del 
del 
del 
del 
del 
del 
del 



scs$sys_level bit (72) aligned ext; 
scs$open_l evel bit (72) aligned ext; 
scs$processor_star t_mask bit (72) aligned ext; 
scs$cpu_test_mask bit (72) aligned ext; 
scs$number_of _masks fixed bin ext; 
scs$processor_start_pattern bit (36) aligned ext 
scs$cpu_test_pattern bit (36) aligned ext; 



/* CAM and CACHE clear info */ 

del scs$cam_pa1r fixed bin (71) ext; 
del scs$cam_wait bit (8) aligned ext; 

/♦ MASKING INSTRUCTIONS & POINTERS */ 

del scs$set_mask (0:7) bit (36) aligned ext; 
del scs$read_mask (0:7) bit (36) aligned ext; 



/* mask used while handling I/O Interrupts */ 

/+ mask used during normal operation */ 

/* mask used when starting up a CPU */ 

/* mask used for ISOLTS CPU testing */ 

/* number of masks (starting at sys_level) */ 

/* SMIC pattern used to send processor start interrupt */ 

/* SMIC pattern used for ISOLTS processor testing */ 



/* instructions XEDd when CAMing and clearing CACHE */ 
/* Used when evicting pages from main memory */ 



/* instructions to set mask (STAQ or SMCM) */ 
/* Instructions to read mask (LUAQ or RMCM) */ 
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del scs$mask_ptr (0:7) ptr unaligned ext; 
/* MISCELLANEOUS */ 

del 1 scs$processor_test_data aligned ext. 
( 

2 active bit (1), 
2 scustate bit (2). 

2 padl bit ( 15), 
2 cpu tag fixed bin (5), 
2 scujag fixed bin (5). 
2 mask_cpu fixed bin (5) 
) unal Igned; 



/♦ pointers for real or simulated masks */ 



/* Info used for cpu testing */ 

/* ■ "l"b if cpu currently under test */ 

/* state of scu being used for testing (see definition below) +/ 

/* tag of cpu under test */ 

/+ tag of scu being used for cpu testing */ 

/* tag of active cpu that has mask asigned to above scu +/ 



/* scu_state ■ H 00"b ■> SCU defined by scs$processor_test_data.scu_tag not yet effected */ 
/* scu_state ■ "01 "b -> all core removed from SCU, port mask not yet changed */ 
/* scu_state ■ "10"b ■> all core removed from SCU, port mask changed */ 

/* scujstate - " 1 1 "b •> only 64k at base of SCU being used for testing, original port mask restored */ 



del scs$1dle_aptep (0:7) ptr unaligned ext: 



del 
del 
del 
del 
del 
del 
del 
del 
del 
del 
del 
del 
del 

del 

del 

del 

del 

del 

del 
del 
del 
del 

del 

dell 



scs$connect_lock bit (36) aligned ext; 
scs$reconf ig_1ock bit (36) aligned ext; 
scs$troub1e_f lags bit (8) aligned ext; 
scs$bos_restart_f lags bit (8) aligned ext; 
scs$nprocessors fixed bin ext; 
scs$bos_processor_tag fixed bin (3) ext; 
scs$f aul ts_1n1 t iaTlzed bit (1) aligned ext; 
scs$sys_trouble_pending bit (1) aligned ext; 
scs$f ast_cam_pending (0:7) bit (36) aligned ext; 
scs$1nterrupt_control ler fixed bin (3) ext; 
scs$processor_start_1nt_no fixed bin (5) ext; 
scs$processor bit (8) aligned ext; 
scs$processor_start_wa1 t bit (8) aligned ext: 

scs$trouble_dbrs (0:7) fixed bin (71); 

scs$port_address1ng_word (0:7) bit (3) aligned ext; 

scs$cfg_data (0:7) fixed bin (71) aligned ext; 

scs$cf g_data_save fixed bin (71) aligned ext; 



/* pointer to idle process APTE for each processor */ 

/* lock for sending connects */ 

/* Lock used during reconfiguration */ 

/* checkoff flags for sys_trouble stopping */ 

/* checkoff flags for restarting after sys_trouble +/ 

/* number of runnung processors +/ 

/* CPU tag of processor running BOS */ 

/* ON after faults have been enabled */ 

/* sys_trouble event Is pending in the system */ 

/* checkoff cells for cam connect */ 

/* port number of low order controller */ 

/* Interrupt cell for starting a processor */ 

/* bits ON for online CPUs ♦ / 

/* checkoff flags for waiting for new processor */ 

/* DBR values at system crash time +/ 

/* active module port number for each controller */ 

/* RSCR-CFG data from each controller */ 

/* RSCR-CFQ save area for ISOLTS CPU testing */ 



scs$expanded_ports bit (1) unaligned dim (0:7) external; 

/♦ Which ports have expanders */ 

scs$processor_switch_data (0:4) bit (36) aligned ext; /* raw data from RSW 0 thru 4 */ 
scs$processor_switch_template (0:4) bit (36) aligned ext;/* expected data from RSW 0 thru 4 */ 
scs$processor_swi tchjeompare (0:4) bit (36) aligned ext; /* discrepancies from expected data */ 
scs$processor_sw1 tch_mask (0:4) bit (36) aligned ext; /* masks for comparing switch data */ 

scs$processor_data_sw1tch_value bit (36) aligned eixt; /* Correct value for CPU data switches */ 

scs$contro1 ler_conf ig_size (0:7) fixed bin (14) aligned ext; 

/* Controller size on config card */ 
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del scs$reconf ig_locker_id char (32) aligned ext; /* process group ID of process doing reconfiguration */ 

del scs$scas_page_tab1e (0:31) bit (36) aligned external static; 

/+ PTWs for SCAS pages ♦ / 

del scs$cycle_pr1orlty_template bit (7) aligned ext; /* template for setting anti-hog switches */ 

del scs$set_cycle_swi tches bit (1) aligned ext; /* flag to set ant-hog switches */ 



del ( 

I0M_P0RT init (1). 
CPU_P0RT init (2). 
BULK_P0RT init (3) 

) fixed bin int static options (constant); /+ values for scs$por t_data . ass igned */ 



/♦ END INCLUDE FILE scs.incl.pll */ 
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sdw. 168. Incl . pi 1 segment In: > 1 dd> i nc 1 ude contents modified: 07/29/81 1747.8 

entry modified: 03/10/82 0836.9 



/* BEGIN INCLUDE FILE ... sdw . 1 68 . Incl . pi 1 ... Updated for ADP conversion 03/01/81 */ 
/+ Note: This Include file has an ALM counterpart made with elf. Keep It up to date ♦/ 



del 11 168_sdw based (sdwp) aligned, 

• (2 add bit (24), 
2 rings, 

3 rl bit (3). 

3 r2 bit (3). 

3 r3 bit (3). 
2 val id bit (1), 
2 df no bit (2). 



padl bit (1). 
bound bit (14), 
access , 

3 read bit ( 1 ) , 
3 execute bit ( 1 ) . 
3 write bit (1), 
3 privileged bit (1). 
unpaged bit ( 1 ) , 
not_a_gate bit (1). 
cache bit (1). 

entry_bound bit (14)) unaligned; 



/* Level 68 Segment Descriptor Word */ 

/* main memory address of page table */ 
/* ring brackets for the segment */ 



/* directed fault bit (0 *> fault) */ 
/* directed fault number */ 



/♦ boundary field (In 16 word blocks) */ 

/* access bits */ 

/* read permission bit */ 

/* execute permission bit */ 

/* write permission bit */ 

/* privileged bit */ 

/* segment is unpaged if this Is 1 */ 

/+ If this Is O the entry bound Is checked by hardware */ 
/* cache enable bit */ 
/* entry bound +/ 



/* END INCLUDE FILE 



sdw. 168. incl .pi 1 */ 
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sdwinfo. incl .pi 1 



segment in: >!dd> include contents modified: 07/29/81 1747.8 

entry modified: 03/10/82 0836.9 



/* BEGIN INCLUDE FILE ... sdw_info.inc1.p11 ... 12/16/80. for ADP conversion ♦/ 

/* Note: This include file has an ALM counterpart made with cif. Keep It up to date ♦/ 



del sdw_info_ptr pointer; 

del 1 sdw_info aligned based (sdw_inf o_ptr ) . 
2 address fixed bin (26). 
2 s ize f Ixed bin ( 19) . 

2 access unaligned, 

3 read bit (1) unaligned, 

3 execute bit (1) unaligned, 

3 write bit (1) unaligned. 

3 privileged bit (1) unaligned. 

2 padl bit (32) unaligned, 

2 rings unaligned, 

3 rl bit (3) unaligned. 
3 r2 bit (3) unaligned. 
3 r3 bit (3) unaligned, 

2 pad2 bit (27) unaligned. 

2 f 1 ags a) igned, 

3 paged bit (1) unaligned. 
3 faulted bit (1) unaligned. 
3 cache bit (1) unaligned, 
3 pad3 bit (33) unaligned, 

2 gate_entry_bound fixed bin (14); 

/* END INCLUDE FILE ... sdw_info. incl .pi 1 +/ 



/* Structure describing SDW contents */ 

/♦ Address of seg base or of page table */ 

/♦ Max length of segment (NOT offset of last word) */ 

/* REWP */ 



/♦ Ring brackets */ 



/* M 1"b 
/* »i»b - 
/* »i»b » 



> Segment is paged */ 

> SDW has fault set */ 

> Segment is encacheable */ 



/* Number of entrypoints in gate, or zero +/ 
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segment In: > 1 dd> 1 nc 1 ude contents modified: 04/02/79 1405.9 

entry modified: 03/10/82 0836.7 



/* 
/* 

declare 



BEGIN INCLUDE FILE ... signal I er_stack. Incl .pi 1 ... Created Feb 79 by D.Spector */ 
This file matches signal ler_s tack . Incl .aim and Is currently used only by ver1fy_1ock */ 



1 signal lers tack based unaligned. 
2 pad (B) bit (36), 
2 mach_cond (48) bit (36), 
2 mc_ptr ptr aligned, 
2 null_ptr ptr aligned, 
2 str 1ng_descr Iptor bit (36), 
2 ptr_descr Iptor bit (36). 
2 argl 1st ( 18) bit (36), 
2 signa1_8tr1ng char (32). 
2 on_un1t (16) bit (36), 
2 h1story_registers (128) bit (36); 



/* Make machine conditions 0 mod 16 */ 

/* Machine conditions */ 

/* Pointer to machine conditions */ 

/+ Null pointer */ 

/+ Condition name descriptor */ 

/* M.C. ptr descriptor */ 

/* Arg list for call to signal */ 

/* Condition name */ 

/* Must be at 128 in stack frame */ 



/* on_unit must start at 128 because trap_cal 1er_cal ler__ sets up a stack frame 
assuming this to be so. Similarly mach_cond must start at 48. */ 



/* 



END INCLUDE FILE 



signal ler_stack. Incl .pi 1 



*/ 



Includ' **, hard, source s Ignal ler_stack 'ncl.pl 1. ^-^ge 87 

F80A* jt to be reproduced 



s 1 1 . i nc 1 . p I 1 



segment in: > 1 dd> i nc lude contents modified: 05/12/82 1246.5 

entry modified: 05/12/82 1254.5 



/* BEGIN INCLUDE FILE slt.incl.plt --- Last modified 2/76 SHW ♦/ 

/* Declarations for Segment Loading Table header and array. 

Used by Initialization and MST Checker subroutines */ , 

/+ pointer to base of SLT segment */ 

/+ pointer to base of SLT names segment +/ 

/* pointer to segment name list block */ 

/+ pointer to segment's directory path name */ 

/+ pointer to ad structure */ 

/♦ declaration of Segment Loading Table (SLT) */ 

/♦ words O- 1 . pointer (ITS pair) to name segment */ 

/* word 2,* start of free core after perm-wired +/ 

/+ word 3, first supervisor segment number */ 

/* word 4, last supervisor segment number */ 

/♦ word 5, first initializer segment number */ 

/* word 6, last initializer segment number */ 

/* size (in words) of free core after perm-wired */ 

/+ segment entries (4 words each) */ 

/* Space for SLT entries */ 

/* auxiliary segment of SLT for storing of segment names and directory path names */ 



dec 1 are 


1 


name seg based (names ptr) aligned. 


/♦ 


name segment header */ 








2 pad bit (18) unal , 












2 next loc bit (18) unal. 


/♦ 


Next available free location In name seg 


*/ 






2 ht (0:127) bit (18) aligned; 


/♦ 


Names hash table */ 




declare 


1 


segnam based (namep) aligned, 


/* 


declaration for segment name block */ 








2 count fixed bin (17), 


/♦ 


number of segment names in this block */ 








2 names (50 refer ( segnam. count )) , 


/♦ 


segment name array ♦/ 








3 hp bit (18) unal , 


/♦ 


hash thread pointer */ 








3 ref bit ( 1 ) unal . 


/♦ 


"1"b if name referenced */ 








3 pad bit (5) unal , 












3 segno bit (12) unal, 


/♦ 


segment number associated with this name 


*/ 






3 name char (32) una); 


/♦ 


space for name (max 32 characters) */ 




dec 1 are 


1 


path based (pathp) al igned. 


/* 


declaration for directory path name */ 








2 size fixed bin (17). 


/* 


length of pathname +/ 








2 name char (168 refer (path. size)) unal. 


/* 


directory path name */ 








2 acls f ixed bin; 


/♦ 


ACL 1 1st starts here */ 




declare 


1 


acls based (aclp) aligned, 


/* 


declaration for acl list +/ 








2 count fixed bin. 


/♦ 


number of entries in acl list */ 








2 acl (50 refer (ac 1 s . count )) , 


/* 


array of acl entries */ 








3 user id char ( 32 ) . 


/* 


user specification +/ 








3 mode bit (36) aligned. 


/* 


mode for the specified user */ 





del si tp ptr , 

names_ptr ptr, 
namep ptr, 
pathp ptr, 
aclp ptr; 

declare 1 sit based (sltp) aligned. 
2 name_seg_ptr ptr. 
2 f ree_core_start fixed bin (24). 
2 f 1rst_sup_seg fixed bin (18). 
2 last_sup_seg fixed bin (18), 
2 f irst_init_seg fixed bin (18). 
2 Iast_1n1t_8eg fixed bin (18), 
2 f ree_core_s ize fixed bin (24), 
2 seg (0:8191) aligned. 

3 site (4) fixed bin (35); 
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3 pad bit (36) aligned, 
3 code fixed bin; 



/* END INCLUDE FILE slt.lncl.pll */ 
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segment II n: > 1 dd> 1 nc 1 ude contents modified: 10/06/82 1356.3 

entry modified: 10/06/82 1359.7 



/* BEGIN INCLUDE FILE slta.lncl.pll ♦ / 

/ + Declaration for Segment Loading Table Entry structure. 

Used by Initialization, MST Generation, and MST Checker subroutines */ 
/* last modified 5/4/76 by Noel I. Morris */ 
/* format: style3 */ 



del 



s 1 tep 



ptr ; 



del 



/ * * ♦ ♦ 



I slte_uns 
( 



based (sltep) aligned, 



2 


names_ptr 


bit 


(18), 






/* 


rel pointer to thread of names */ 


2 


path_ptr 


bit 


(18). 






/* 


rel pointer to pathname (if present) */ 


word 1 + / 














2 


access 


bit 


(4). 






/ * 


sow access bit (RcWP) */ 


2 


cache 


bit 


( 1). 






/* 


Segment to be allowed in cache */ 


2 


abs_seg 


bit 


(1). 






/* 


segment is an abs seg if ON */ 


2 


f i rmware_seg 


bit 


(1). 






/* 


load In low 256 */ 


2 


1 ayout_seg 


bit 


(1). 






/* 


mailbox & such */ 


o 


pad 1 


bit 


(4), 






/* 


unused +/ 


2 


w 1 red 


bit 


(1). 






/ * 


segment Is wired if' ON */ 


2 


paged 


bit 


(1). 






/* 


segment is paged if ON */ 


2 


per_process 


bit 


(1). 






■ i * 




2 


pad3 


bit 


(2), 










2 


acl provided 


bit 


(1). 






/* 


ON if acl structure follows path_name on MST */ 




1st half of word 


2 ♦/ 










2 


pad4 


bit 


(3). 










2 


branch_requ 1 red 


bit 


( 1). 






/* 


path name supplied if ON */ 


2 


ini t_seg 


bit 


(1). 






A 


segment is initseg If ON */ 


2 


temp_seg 


bit 


(1). 






/* 


segment is temp_seg If ON */ 


2 


I ink_prov ided 


bit 


(1). 






/* 


1 linkage segment provided If ON */ 


2 


1 ink_sect 


bit 


(1). 






/♦ 


segment is linkage segment if ON */ 


2 


1 ink_sect_wired 


bit 


( 1). 






/♦ 


1 linkage segment is wired If ON ♦/ 


2 


comb1ne_l Ink 


bit 


(1). 






/* 


1 linkage is combined if ON */ 


2 


pre_l Inked 


bit 


( 1). 






/* 


lot entry has been made if ON */ 


2 


def s 


bit 


(1). 






1* 


segment is definitions segment if ON */ 


f 


word 2 */ 














2 


pad5 


bit 


(6). 










2 


cur_length 


f ixed bin 


(9) 


uns , 


h 


current length of segment (In 1024 word blocks) 


2 


r ingbrack 


(3) 


f ixed 


bin 


(3) uns. 


/♦ 


r Jngbrackets */ 


2 


segno 


f ixed bin 


(18) 


uns , 


/* 


text/link segment number */ 


f 


word 3 */ 














2 


pad7 


bit 


(3). 










2 


max_length 


f i xed bin 


(9) 


uns . 


/* 


maximum length for segment +/ 


2 


bi t_count 


f ixed bin 


(24) 


uns 






) 




unal igned; 






/* 


btltcount of segment */ 



del 1 site based (sltep) aligned. 

( 2 namesptr bit (18). 

2 path_ptr bi t ( 18) . 

2 access bit (4). 



/* rel pointer to thread of names */ 

/* r€il pointer to pathname (if present) */ 

/♦ SOW access bit (REWP) ♦/ 
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2 


cache 


D1 i 


i * \ 


/ * 


Segment to be at lowed in cache. */ 




abs_seg 


kit 
Oil 


i \\ 


/ * 


segment, is an aos seg it un •/ 


z 


f 1 rroware_seg 


K i ♦ 
Dl l 


i i\ 
\ 1 1 # 






2 


1 a you t_seg 


bit 


i * \ 






2 


pad2 


bi t 


(4), 




segment is wired if ON */ 


2 


w 1 red 


bit 


/ 4 \ 


/* 


2 


paged 


bi t 


( 1 ) . 


/* 


segment is paged if ON +/ 


2 


per_process 


bi t 


/ 4 \ 


/* 


segment is per-process if ON */ 


2 


pad3 


bit 


(2) . 






2 


ac1_provided 


bit 


( 1 ) . 


/* 


ON if acl structure follows path_name on MST +/ 


2 


pad4 


bi t 


(3) . 






2 


branch_requ i red 


bi t 


( 1 ) . 


/* 


path name supplied if ON */ 


2 


ini t_seg 


bi t 


i J > 

( 1 ). 


/* 


segment is 1n1t_seg if ON */ 


2 


tempseg 


bi t 




/ + 


segment is temp_seg if ON +/ 


2 


1 1nk_provided 


b i t 


/ 4 \ 


/* 


linkage segment provided if ON +/ 


2 


1 ink_sect 


bit 


/ 4 1 


/* 


segment Is linkage segment if ON */ 


2 


1 ink_sect_wired 


bit 


t 4 \ 


/* 


linkage segment Is wired if ON */ 


2 


comblne_1 Ink 


bit 


{ 1-1 . 


/* 


linkage is combined if un */ 


2 


pre_l Inked 


bit 


(111 


/* 


lot entry has been made If ON */ 


2 


def s 


bit 


t 4 \ 
I 1 ) t 


/* 


segment is definitions segment if ON */ 


2 


pad5 


bit 


(6 ) , 




current length of segment (in 1024 word blocks) */ 


2 


cur_1 ength 


bit 


(9) . 


/* 


rt 

J. 


r l nyDracK 


(3) 


bit (3). 


/ * 


1 lllyUI aLKH lb / 


2 


segno 


bit 


(18). 


/* 


text/link segment number */ 


2 


pad6 


bit 


(3). 






2 


maxl ength 


bit 


(9). 


/* 


maximum length for segment */ 


2 


b 1 t_count 


bit 


(24) 






) 




unal igned; 


/* 


bitcount of segment */ 



/* END INCLUDE FILE si te. incl .pi 1 */ 
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sst . Incl .pi 1 



segment in: > 1 dd> i nc 1 ude 

entry modif led: 11/19/82 1604.3 



contents modified: 11/19/82 1602.2 



/♦ BEGIN INCLUDE FILE ... sst. incl. pi 1 ... January 197 1 ♦/ 

/* Note: This Include file has an ALM counterpart made with cif. Keep It up to date */ 



del 
del 



sst_seg$ externa); 
sstp ptr; 



del 1 


sst based (sstp) aligned, 






2 


space (8) fixed bin, 


/♦ 


empty space to watch for bugs */ 


/* SST HEADER ♦ / 






2 


pre_page_t ime fixed bin (71), 


/* 


total time spent pre -paging */ 


2 


post_purge_t ime fixed bin (71), 


/* 


total time spent post-purging */ 


2 


post_1n_core fixed bin. 


/* 


total pages in core (and in 11st) at purge time +/ 


2 


thrashing fixed bin. 


/* 


meter of thrashing being done on system +/ 


2 


npfsraisses fixed bin. 


/* 


meter of times npfs was on when pre-paging */ 


2 


sal v f ixed bin. 


/* 


flag which is ~»0 if and only If salvaging */ 


2 


ptl bit (36). 


/* 


global page table loop lock */ 


2 


astl bit (36), 


/* 


global ast allocation block lock */ 


2 


astl_event bit (36), 


/* 


event used when waiting for AST lock */ 


2 


ast 1_not 1 f y_requested bit (1) aligned. 


/* 


flag to notify AST lock'*/ 


2 


nused fixed bin. 


/* 


number of pages on used list */ 


2 


ptwbase fixed bin (24). 


/* 


absolute address of page table array */ 


2 


tfreep ptr. 


/* 


pointer to first trailer on free list */ 


2 


astap ptr. 


/* 


aste array pointer */ 


2 


bulk_pvtx fixed bin (8) aligned. 


/♦ 


pvtx of bulk store, zero if none .*/ 


2 


pt1_wait_ct fixed bin, 


/* 


pxss: number is >= 0 of processes waiting to ptl */ 


2 


astsize fixed bin. 


/* 


size of an AST entry */ 


2 


cmesize fixed bin. 


/* 


size of a CME entry */ 


2 


root_astep ptr. 


/* 


pointer to the root AST entry */ 


2 


pts (0: 3) fixed bin. 


/* 


array of page table sizes */ 


2 


level (0:3). 


/* 


per- list information about ASTE's */' 




3 (ausedp, no_aste) bit (18) unaligned. 


/* 


used list and count of number of entries */ 


2 


(atempp, atemppl) bit (18) unal , 


/♦ 


temp seg list pointer */ 


2 


dm enabled bit (1) aligned. 


/* 


ON ■> journal seg exists */ 


2 


(ainitp, alnitpl) bit (18) unal. 


/♦ 


in4t seg list pointer +/ 


2 


strs ize f ixed bin. 


A 


Trailer size in words. +/ 



/* CORE MAP HEADER */ 

2 cmp ptr, 

2 usedp bit ( 18), 

2 wtct f ixed bin. 



/♦ pointer to start of core map */ 

/* pointer to first used core block */ 

/* count of pages being written */ 
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2 startp bit ( 18) , 
2 removep bit ( 18) , 



2 double__wr 1 te fixed bin, 



2 temp_w_event bit (36) aligned, 

2 root_pvtx fixed bin, 

2 ptw_ftrst bit (1) aligned, 

2 nolock bit (1). 

2 x_fsdctp bit (18). 

2 fc_sk 1ps_p1nned fixed bin (35). 

2 c1_sk 1ps_p1nned fixed bin (35), 

2 ast_ht_ptr ptr, 

2 ast_ht_n_buckets fixed bin, 

2 ast_ht_uid_mask bit (36) aligned, 

2 meter_ast_1ock Ing fixed bin. 

2 check sum_f 1 lemap fixed bin, 

/* 100 octal */ 

2 page_read_errora fixed bin. 
2 pagewr i te_errors fixed bin. 
2 rws_read_errors fixed bin, 
2 rws_write_errors fixed bin, 

2 cycle_pv_a11ocat Ion fixed bin, 

2 n_tra11ers fixed bin, 

2 synch_act i vat Ions fixed bin (35), 

2 synchskips fixed bin (35), 

2 lockwalts fixed bin, 
2 total _1ocks_set fixed bin, 
2 pdir_page_f aul ts fixed bin, 
2 level_1_page_f aul ts fixed bin. 
2 d1r_page_fau1 ts fixed bin, 
2 r1ng_0_page__faul ts fixed bin. 
2 rqover fixed bin (35), 
2 pc_io_wa1ts fixed bin, 



/* The following (until pdmap) used to be the 

2 steps f ixed bin, 

2 needc fixed bin, 

2 ceiling fixed bin, 

2 ctwalt fixed bin. 

2 wired fixed bin, 

2 laps f ixed bin, 

2 skipw fixed bin. 



includ +, hard. source 
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/* pointer to solid page for lap counting (fsdct) */ 
/* pointer to list of pages being removed from use */ 
/* MISC */ 

/* trigger for store through scheme +/ 
/+ 0 - no double writes, 

1 • all non-pd pages get written. 

2 ■ all directories get written +/ 
/* wait event for temp wiring lock */ 

/♦ pvtx or rpv */ 

/* flag controlling when pages go to pd */ 
/* if on. don't lock ptl on interrupts */ 
/* removed by thvv */ 

/* number of skips over pinned page in f1nd_core */ 

/* number of skips over pinned page in claim_mod_core +/ 

/* AST hast table pointer */ 

/* number of buckets in AST hash table */ 

/* mask to strip out low-order bits of uid */ 

/* non-zero enables AST lock meters */ 

/* non-zero enables fi lemap checksumming +/ 



/* read errors posted to page control */ 
/* write errors posted to page control ♦/ 
/+ read-side rws errors */ 
/+ write-stde rws errors */ 

/+ flag to cycle VTOCE allocation among PVs */ 

/+ Number. of trailer entries In str_seg */ 

/* Activation attempts for synchronized segs */ 

/* get_aste skips because not synchronized */ 

/* Number of times we had to wait for a lock */ 

/♦ Total number of block locks set */ 

/* total page faults off >pdd */ 

/* total page faults In sys 1 ibes */ 

/+ Total page faults on directories */ 

/+ page faults in ring 0 */ 

/* errcode for record quota overflow */ 

/* Number of times pc had to wait on 1o */ 



'cnt' In cnt . incl .pi 1 */ 



/* number of steps taken around used list */ 

/* number of times core page needed */ 

/* number of times ceiling hit */ 

/* number of times write counter was full */ 

/+ number of pages wired by pc */ 

/* number of times around used 11st */ 

/* number of pages sktped because they were wired */ 
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2 sk Ipu f ixed bin. 

2 sk tpm f ixed bin, 

2 sk ipos f i xed bin, 

2 sklpspd fixed bin, 

2 aused f ixed bin, 

2 damagedct fixed bin,, 

2 deact_count fixed bin, 

2 demand_deact_at tempts fixed bin, 

2 demand_deact i vat ions fixed bin, 

2 reads (8) fixed bin. 
2 writes (8) fixed bin, 

2 shortpf count fixed bin, 

2 loop_ locks fixed bin, 

2 loop_lock_ti me fixed bin (71). 

2 cpu_sf_time fixed bin (71), 

2 totalsfpf fixed bin, 

2 tota1_sf fixed bin. 

2 pre_page_s ize fixed bin, 

2 post_1 ist_size fixed bin. 

2 post_purgings fixed bin, 

2 post_purge_cal 1 s fixed bin, 

2 pre_page_ca I 1 s fixed bin, 

2 pre_page_l 1st_s ize fixed bin, 

2 pre_page_m i sses fixed bin, 

2 pre_pagings fixed bin, 

/* 200 octal */ 

/* TEMPORARY WIRED PROCEDURE INFO */ 

2 wire_proc_data (8) fixed bin (71) 

/* MAIN MEMORY USAGE INFORMATION */ 

2 abs_wired_count fixed bin. 
2 system_type fixed bin, 
2 w1red_copies fixed bin. 
2 recopies fixed bin, 
2 f irstcoreblock fixed bin, 
2 last_core_block fixed bin, 
2 fw_retries fixed bin (35), 
2 pvhtp ptr unaligned. 

/* AST METERS */ 

2 askipsize (0: 3) fixed bin, 
2 aneedsize (0: 3) fixed bin, 

2 stepsa fixed bin, 
2 askipsehs fixed bin, 
2 asearches fixed bin. 
2 askipslevel fixed bin, 
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/* because of being used */ 

/* because of being modified ♦/ 
/* because out of service +/ 

/* number of times a block of core was skipped for active rws ♦/ 

/* number of AST entries on used list */ 

/* count of segments that system damaged */ 

/♦ count of deactivations */ 

/♦ user requested deactivations */ 

/* user instigated deactivations */ 

/* number of reads for each did */ 
/* number of writes for each did */ 

/* count of page faults on out of service pages */ 

/* count of times locked PTL ♦/ 

/* time spent looping on PTL */ 

/* cpu time spent In seg_fault */ 

/* total page faults while in seg_fault */ 

/* total number of seg_faults */ 

/* total pre-pagings expected */ 

/* total number of post -purglngs */ 

/* total number of calls to post -purge */ 

/+ total number of calls tp pre -page +/ 

/* total number of misses In pre-page list */ 
/* total number of pre-pagings */ 



/♦ data for wire_proc */ 



/+ count of abs-wired pages */ 

/* ADP_SYSTEM or- L68_SYSTEM ♦/ 

/* number of times a wired page was copied */ 

/* number of times recopied because modified */ 

/* core map index for first block of core */ 

/* core map index for last block of core */ 

/* force_write retries due to ASTE move */ 

/* ptr to PV hold table for debugging */ 



/* array of skips because wrong AST size */ 

/* array of times needed each size */ 

/* count of steps taken looking for an AST entry */ 

/* count of skips because EHS was ON */ 

/* count of full searches made */ 

/+ count of skips because pages were In core */ 
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2 askipsinit fixed bin, 
2 acost f 1 xed bin, 
2 ask Ips lock fixed bin, 
2 asklpdius fixed bin, 

2 a laps fixed bin, 

2 updates fixed bin, 

2 setfau1ts_al1 fixed bin, 

2 setf aul ts_acc fixed bin, 

2 total bf fixed bin, 

2 total "bf_pf fixed bin, 

2 cpu_b?_time fixed bin (71), 

2 asteps (0: 3) fixed bin, 

2 ast_locked_at_t1me fixed bin (71), 

2 ast_1ocked_total_tirae fixed bin (71). 

2 ast_lock_wait_time fixed bin (71), 

2 ast_lock ing_count fixed bin (35), 

2 cleanup_count fixed bin, 

2 cleanups_w1 th_any_rw8 fixed bin, 

2 deanup_rws_count fixed bin. 

2 cleanup_rea1_t itne fixed bin (71). 

/* PRE-PAGE METERS */ 

/* 300 octal */ 

2 tree_count (0: 63) fixed bin, 
/* 400 octal */ 

2 pp_meters (0: 63) fixed bin, 

/* End of old cnt include file */ 

/* 500 octal */ 

2 wusedp bit (18) aligned, 

2 write_hunts fixed bin, 

2 c1.aim_skip_cme fixed bin, 

2 claim_sk ip_f ree fixed bin, 

2 clalmnotmod fixed bin, 

2 clalmpassedused fixed bin, 

2 c I a imsk ipptw fixed bin, 

2 claim_writes fixed bin, 

2 cl a imsteps fixed bin, 

2 rws_reads_os fixed bin, 

'2 pd_updates fixed bin, 

2 pre_seeks_f al led fixed bin, 

2 pddesperat 1on_steps fixed bin, 

2 pd_desperat ions fixed bin, 

2 skips_nypd fixed btn, 

2 pd_wr 1 teahead bit (1) aligned, 

2 pd_desperat ions_not_mod fixed bin. 



i nc 1 udf * * , hard . source 
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count of tiroes turned OFF 1nlt switch */ 
cumulative cost of deactivations */ 
count of skips because couldn't lock parent 
count of skips because OIUS was on */ 

lap counter for AST list */ 

calls to updateb */ 

setf aul ts done to the entire SOW */ 

setf aul ts done to the access field +/ 

count of bound faults */ 

page faults during bound faults */ 

cpu time spent in bound fault */ 

per-size AST step counters +/ 

clock reading when ast last locked */ 

total real time the ast lock was locked +/ 

total real time of all waiting on ast lock 

number of times ast was locked */ 

calls to pc$cleanup */ 

ditto, with >0 rws's */ 

total rws's started by cleanup +/ 

total real time in pcicleanup */ 



counters for pre-page decisions */ 



counters for measuring pre-page success */ 



Relative cmep to next cme for writing */ 

Times c1a1m_mod_core invoked */ 

Times unacceptable cme found by c_m_c */ 

Times free cme passed by c_m_c */ 

Times c_m_c passed pure page */ 

Times used page seen +/ 

Times c_m_c saw unacceptable ptw */ 

Writes queued by c_m_c */ 

Steps passed. In core claiming */ 

RWS reads outstanding, in SST for debugging 

done_ time pd writes */ 

counter of times quick find_core_ failed */ 
steps of allocate_pd finding pdme */ 
times allocate_pd needed to force one free 
find_core skips for nypd pages +/ 
"1"b ■> a11ocate_pd at disk done time */ 
desperations on pure pages */ 



2 resurrections fixed bin. 

2 volmap_seg_page_f aul ts fixed bin (35), 

2 oopv f 1 xed bin. 

2 pdf 1 ushrepl aces fixed bin, 

2 pcrsststatptr ptr unal , 

2 pdresurrect Ions fixed bin. 

2 dbl wresurrect ions fixed bin, 

2 sgm_time fixed bin (71). 

2 sgm_pf f ixed bin. 

2 bad_sgms fixed bin. 

2 sgm_sgft fixed bin. 

2 good_sgms fixed bin, 

2 claimruns fixed bin. 

2 activations fixed bin, 

2 dir_acti vat Ions fixed bin, 

2 hedge_updatevs fixed bin. 

2 hedgewrltes fixed bin, 

2 ev ict_recover_data . 

3 evlctptp bit (18) unal, 

3 ev1ct_phmb1t bit (18) unal, 

/* Data for metering force_write facility 08/19/78 

2 f orce_swr i tes fixed bin. 
2 f orce_pwr 1 tes fixed bin, 
2 fw_none fixed bin, 
2 f orce_updatevs fixed bin, 

2 pf _pd_loop_t Ime fixed bin (7 1), 
2 pf_unlock_pt l_t ime fixed bin (71), 
2 pf_pd_loop_meter ings fixed bin, 
2 pf_unlock_ptl_meter ings fixed bin, 

2 makeknown_act 1 vat ions fixed bin (35). 
2 backup act 1 vat ions fixed bin (35). 
2 meter ing_f lags aligned. 

3 act 1 vate_act 1 vated bit (1) unal. 

3 pad bit (35) unal , 
2 segf aul t_ca1 Is fixed bin (35), 

/♦ Meters for stack truncation +/ 

2 ( stk_truncate_should_didnt . 

stk_truncate_should_did. 

stk_truncate_shouldnt_didnt . 

stk_truncate_shou1dnt_d1d) fixed bin (35). 
2 stk_pages_truncated fixed bin (35). 
2 stk_pages_truncated_in_core fixed bin (35), 

2 padder (8) fixed bin. 

/* the following data is used by page multilevel */ 

/ + 600 octal ♦/ 
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/* nulled addresses reinstated */ 

/♦ Pseudo-page faults on volmap_seg */ 

/* out-of -physical -volume page faults */ 

/+ addresses "corrected" by post -crash pd flush */ 

/* ptr to damage table of pc_recover_sst */ 

/* addresses resurrected at RWS time ♦/ 

/♦ addresses resurrected by double-writing */ 

/♦ Time (N/CPU) in seg mover */ 

/+ Page faults in seg moving */ 

/* Seg moves that failed +/ 

/* Seg faults In seg moves «•/ 

/* Seg moves that completed */ 

/* Times cla1m_mod_core had to run */ 

/* total count of activations */ 

/* count of directory activations */ 

/* call-in updatevs */ 

/♦ call In core flush writes ♦/ 

/* see evfct_page. aim */ 

/* ptp of page being moved ♦/ 

/* N/Z if page was mod */ 



/* Calls on segments to force write */ 

/* Mod pages so written */ 

/* Force write wrote none */ 

/* Updatev's so forced */ 

/* Time looping on pd on page faults */ 

/* Time unlocking ptln page faults */ 



/* activations at makeknown time */ 

/* activations for backup */ 

/* small chunks of misc. information */ 

/* ON => last call to activate entry actually activated something +/ 

/+ number calls to seg_fault for explicit activation */ 



/+ counts */ 
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2 pdmap ptr, 
2 pdhtp ptr, 

2 pd_1d fixed bin (8) aligned. 

2 pdslze fixed bin, 

2 pdme_no fixed bin. 

2 pdusedp bit (18) unaligned. 

2 pd_f Irst fixed bin. 

2 pd_map_addr fixed bin. 

2 nrecspdmap fixed bin. 

2 pd_free fixed bin, 

2 pd_us1ng fixed bin, 

2 pdwtct fixed bin, 

2 pd_wr1tes fixed bin, 

2 pdce 11 1 ng f 1 xed bin, 

2 pd_steps fixed bin, 

2 pd_sk ips_1ncore fixed bin, 

2 pd_sk1ps_rws fixed bin, 

2 pdneeded fixed bin, 

2 mod_dur1ng_wr1te ft xed bin, 

2 pd_wr1 te_aborts fixed bin, 

2 pd_rws_act 1 ve fixed bin, 

2 pd_no_free fixed bin, 

2 pd_read__truncates fixed bin, 

2 pd_wr ite_truncates fixed bin, 

2 pd_hts1ze fixed bin, 

2 pd_hash_mask bit (18), 

2 pdmap_astep ptr, 

2 zero_pages fixed bin, 

2 pd_zero_pages fixed bin, 

2 trace_sw al Igned, 

3 pad_trace bit (32) unaligned, 
3 pc_trace_pf bit (1) unaligned. 
3 tty_trace bit (1) unaligned, 
3 pctrace bit (1) unaligned, 
3 sc_trace bit (1) unaligned, 
2 new_pages fixed bin, 
2 rws_t ime_temp fixed bin (71), 
2 rws_t 1me_start fixed bin (71), 
2 rws_t 1me_done fixed bin (71), 
2 pd__t 1me_counts (4) fixed bin, 
2 pd"t 1me_va1ues (4) fixed bin (71). 
2 pd__no_f ree_gtpd fixed bin. 
2 pd pagef aul ts fixed bin, 
2 pd_no_f ree_f irst fixed bin, 
2 update_ Index fixed bin, 
2 lastupdate fixed bin (71), 
2 countpdmes fixed bin, 
2 bucket_overf low fixed bin, 
2 buckets (0:63) fixed bin, 
2 ast_track bit (1) aligned, 
2 dir!ock_wr itebehind fixed bin, 
2 write limit fixed bin, 
2 pad4 (1) fixed bin; 

/* END INCLUDE FILE sst.lncl.pH */ 



/* pointer to the pd map */ 

/* pointer to the pd hash table */ 

/* pvt index of paging device, 0 if none */ 

/+ the number of words In a paging device map entry */ 

/* the number of entries in the paging device map */ 

/+ pointer to head of paging device used list */ 

/* first usable record of paging device +/ 

/* core address of base of paging device map */ 

/* number of records in pd map */ 

/* number of free records on the paging device */ 

/* actual number of pd records being used */ 

/* number of read/write sequences queued */ 

/+ total number of read/write sequences ever made */ 

/* number of times too many rws active at once */ 

/* total steps taken around the pd map +/ 

/* number of entries skipped because page was in core */ 

/* number of entries skipped because a rws was active */ 

/* total number of pd records needed +/ 

/* times a page was modified while It was being written */ 

/* number of pd writes aborted */ 

/* count of current number of active rws's */ 

/* number of times couldn't find a free pd record +/ 

/* number of truncated pages during read of rws */ 

/* number of truncated pages during write of rws */ 

/* number of entries in pd hash table */ 

/+ mask used in pd hashing algorithm */ 

/* pointer to temporary segment for pdmap copying */ 

/* count of pages truncated because all zero */ 

/* as above except also on paging device */ 

/* tracing control flags */ 

/* tracing for page faults, done, etc. */ 

/* flag used by page control primitives */ 

/* flag used by segment control primitives */ 

/* newly created pages */ 

/* temporary used for rws metering */ 

/* time spent initiating rws */ 

/* time spent finishing up rws */ 

/* number of hits in the following bins */ 

/* total residency time for the 4 bins */ 

/* times pages written to disk because gtpd ON */ 

/* total page faults from pd */ 

/* times pages were written to disk because first write */ 

/* temporary used during paging device map update */ 

/* time last paging device update was performed «/ 

/* if non-zero, pdme statistics will be kept */ 

/* counter for overflows */ 

/♦ buckets for pdme stats */ 

/♦ " l"b ■> keep SST name table +/ 

/* "1 to flush modified dir pages in lock$unlock */ 
/* Max ff of outstanding writes by page control */ 
/* padding to 512 words (1000)8 */ 
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segment In: > 1 dd> i nc I ude contents modified: 11/01/79 1033.0 

entry modified: 03/ 10/82 0836.7 



/♦ Begin include file sstnt . incl .pi 1 */ 



/* Created 10/03/74 by Bernard Greenberg ♦/ 

/* modified 08/24/79 by d. A. Bush for easier calculation of size of sstnt +/ 



del sst_names_$ ext; 
del sstnp ptr; 

del 1 sstnt based (sstnp) aligned, 
2 valid bit ( 1 ) al igned. 
2 mul t ics_or_bos char (4) aligned, 
2 nentries fixed bin, 
2 padl (5) fixed bin. 

2 (ast_sizes, 
ast_name_of f sets , 
ast_offsets. 

pad2) (0 : 3) fixed bin. 
2 names (0 : 0 refer ( sstnt . nentr fes ) ) char (32) 
del (sstnmx, ptsi_a) fixed bin (17); 
del nm_astep ptr; 

/♦ End include file sstnt . incl .pi 1 */ 



/* Segment containing sst name table +/ 
/* Pointer to sst name segment */ 
/* Major structure */ 

/* 1 => structure filled by Mul tics */ 

/* Origin of data in table */ 

/* number of entries in the sstnt */ 



/* Sizes of ASTE's at each level +/ 

/* Starting index for names at each level +/ 

/* Starting rel addr of each AST region */ 



varying; /* Names of AST entries +/ 
/* Index Into name table */ 
/* astep to be used */ 
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stack_0_data. Incl .pi 1 segment In: > 1 dd> 1 nc 1 ude contents modified: 10/03/79 1601.4 

entry modified: 03/10/82 0836.7 



/* BEGIN INCLUDE FILE ... stack_0_data . incl . pi 1 */ 

/ + Created 790509 by Mike Grady */ 

del stack_0_data$ fixed bin ext; 

del stack~0_data_1n1t__number_of_stacks fixed bin; 

del sdtp ptr; 

del 1 sdt aligned based (sdtp), 
2 lock bit (36). 
2 num_s tacks fixed bin, 
2 freep bit ( 18). 
2 pad fixed bin. 

2 stacks (stack_p_data_1nit number_of_s tacks 
refer ( 6dt . num_stacks7) like sdte; 

del sdtep ptr; 

del 1 sdte aligned based (sdtep). 
2 nextp bit (18) unal . 
2 pad bit (18) unal . 
2 astep bit (18) unal. 
2 aptep bit (18) unal. 
2 sdw bit (72); 



/* shared stack 0 data base sag ♦/ 
/* Make PL/I work */ 



/* stack 0 database */ 

/* lock before changing threads */ 

/* number of stacks in pool */ 

/* head of free thread, managed LIFO */ 



/* stack data table entry */ 

/* thread to next free entry (if free) */ 

/* ptr to ASTE for this stack seg */ 

/* ptr to APTE of process using this stack, if not free +/ 
/* SDW for this stack seg */ 



/* END INCLUDE FILE 



stack_0_data. incl .pi 1 */ 
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stackframe. Incl .pi 1 



segment In: > 1 dd> i nc 1 ude contents modified: 04/13/78 1 156.1 

entry modified: 03/10/82 0836.6 



/♦ BEGIN INCLUDE FILE ... stack_f rame. incl .pi 1 .... ♦/ 

/* Modified: 16 Dec 1977, D. Levin - to add fiopsptr and pllpsptr */. 

/ + Modified: 3 Feb 1978, P. Krupp - to add run_unl tmanager bit & rnainproc bit */ # 
/* Modified: 21 March 1978. 0. Levin - change fto_ps_ptr to support ptr */ 

del sp pointer; /* pointer to beginning of stack frame */ 



del stack_f rame_min_ length fixed bin static (ntt(48); 



del 1 stackframe based(sp) aligned, 
2 po inter_regi sters(0 : 7) ptr, 
2 prev_sp pointer, 
2 next_sp pointer, 
2 return_ptr pointer. 
2 entry_ptr pointer. 
2 opera tor_and_lp_ptr ptr. 
2 arg_ptr pointer, 
2 stat1c_ptr ptr unaligned. 

2 support_ptr ptr unal, ./* only used by fortran I/O */ 
2 on_un1 t_relp1 bit(IS) unaligned. 
2 on_un1 t_relp2 bit (18) unaligned, 
2 trans lator_id bit(18) unaligned, 



2 operator_return_of f set bit (18) unaligned, 

2 x(0: 7) bit(18) unaligned. 

2 a bit (36) . 

2 q bit(36). 

2 e bit (36). 

2 timer bit (27) unaligned, 

2 pad bit (6) unaligned, 

2 r ingalarmreg btt(3) unaligned; 



/♦ serves as both ♦/ 



/.* Translator ID 

0 -> PL/I version II 

1 => ALM 

2 => PL/I version I 

3 «> signal caller frame 

4 => signaller frame */ 

/♦ index registers */ 
/+ accumulator */ 
/ + q-register */ 
/* exponent */ 

/* timer */ 



del 1 stack_f rame_f lags based(sp) aligned, 

2 pad(0 : 7) bit(72). 

2 xxO bit(22) unal , 

2 main_proc bit(1) unal, 

2 run_un 1 tjnanager bit(1) unal, 

2 signal bl t( 1 ) unal , 

2 crawl_out bit(1) unal, 

2 signaller bit(1) unal. 

2 link_trap bit(1) unal. 

2 support bit(1) unal. 



/* skip oyer prs */ 

/* on if frame belongs to a main procedure */ 

/+ on if frame belongs to run unit manager */ 

/* on if frame belongs to logical s1gnal_ */ 

/+ on if this is a signal caller frame */ 

/* on if next frame is signaller's */ 

/* on if this frame was made by the linker +/ 

/* on if frame belongs to a support proc */ 
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2 condition bit(1) una I . 

2 xxOa bl t (6) una I , 

2 xx 1 fixed bin, 

2 xx2 fixed bin, 

2 xx3 b1t(25) unal , 

2 old_crawl_out bit (1) unal 

2 old_ signal ler blt(l) unal, 

2 xx3a bit (9) unaligned, 

2 xx4(9) b1t(72) aligned. 

2 v2_p1 1_op_ret_base ptr. 



2 xx5 bit(72) al Igned. 
2 Pi 1_.Ps_ptr ptr; 



/* on If condition established In this frame */ 



/* on if this Is a signal caller frame */ 
/* on 1f next frame Is signaller's */ 



/+ When a V2 PL/I program calls an operator the 

* operator puts a pointer to the base of 

* the calling procedure here, (text base ptr) */ 

/* ptr to ps for this frame; also used by fio. */ 



END INCLUDE FILE 



stack_f rame. incl .pi 1 +/ 
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stackheader . incl .pi 1 



segment in: > 1 dd> i nc 1 ude contents modified: 04/13/78 1156.1 

entry modified: 03/10/82 0836.6 



/♦ BEGIN INCLUDE FILE ... stack_header . incl , pi 1 .. 3/72 Bill Silver +/ 

/* modified 7/76 by M. Weaver for 'system links and more system use of areas */ 

/* modified 3/77 by M. Weaver to add rnt_ptr */ 



del sb ptr; 
dc) 1 stack header 



based (sb) aligned, 



2 padl (4) fixed bin. 

2 old_lot_ptr ptr, 

2 comb ined_stat_ptr ptr, 

2 clr_ptr ptr. 

2 max_lot_size fixed b1n(17) unal, 

2 ma in_proc_ Invoked fixed bin (11) unal 

2 run_uni t_depth fixed bin(5) una). 

2 cur lot size fixed bin(17) unal. 



2 system_f ree_ptr 
2 user_f ree_ptr 



ptr , 
ptr , 



2 null_ptr ptr. 

2 stack_begin_ptr ptr, 

2 stack_end_ptr ptr, 

2 lot_ptr ptr, 

2 signal_ptr ptr, 

2 bar_mode_sp ptr, 

2 pi 1_operators_ptr ptr, 

2 ca11_op_ptr ptr, 

2 push_op_ptr ptr, 

2 return_op_ptr ptr, 
2 returnnopopopptr ptr, 

2 entry_op_ptr ptr, 

2 trans_op_tv_ptr ptr, 

2 isot_ptr ptr, 

2 sct_ptr ptr, 

2 unwinder_ptr ptr, 

2 sys_l ink_info_ptr ptr, 

2 rntptr ptr, 

2 ectptr ptr, 

2 ass 1gn_l 1nkage_ptr ptr, 

2 pad3 (8)' bit (36) aligned; 



/♦ 
/* 
/* 

/* 
/♦ 
/* 
/♦ 
/♦ 

/♦ 
/♦ 

/* 
/* 
/♦ 
/♦ 

/* 
/♦ 
/* 
/* 

/* 
/* 
/* 
/♦ 

/* 
/* 
/♦ 
/♦ 

/* 
/* 

/* 
/♦ 
/* 



/♦ the main pointer to the stack header */ 



0) also used as arg list by outwardcal lhandler +/ 
4) pointer to the lot for current ring (obsolete) */ 
6) pointer to area containing separate static */ 



pointer to area containing linkage sections */ 
DU number of words allowed in lot */ 
OL nonzero if main procedure invoked in run unit */ 
DL number of active run units stacked */ 
number of words (entries) in lot */ 



po 
po 

♦/ 
po 
po 
po 

po 
va 
po 
po 

po 
po 
po 
po 

po 
po 
po 
po 

po 
po 
po 
po 



nter to system storage area */ 
nter to user storage area */ 



nter to first stack frame on the stack */ 
nter to next useable stack frame */ 
nter to the lot for the current ring */ 

nter to signal procedure for current ring */ 
ue of sp before entering bar mode */ 
nter to pi 1_operators_$operator_table */ 
nter to standard call operator */ 

nter to standard push operator */ 

nter to standard return operator */ 

nter to standard return / no pop operator */ 

nter to standard entry operator */ 

nter to translator operator ptrs +/ 
nter to I SOT ♦/ 

nter to System Condition Table*/ 
nter to unwinder for current ring ♦/ 

nter to *system 1 ink name table */ 
nter to Reference Name Table */ 
nter to event channel table */ 

nter to storage for (obsolete) hcs_$ass 1gn_l Ink age */ 



for future expansion */ 
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/* The following offset refers to a table within the pi 1 operator table. */ 

del tv_offset fixed bin tntt(3<51) Internal static; /* (551) octal */ 

/* The following constants are offsets within this transfer vector table. */ 

del (call_offset fixed bin 1n1t(271). 

push_offset fixed bin 1n1t(272). 

return_of f set fixed bin 1ntt(273). 

return~no_pop_of f set fixed bin tntt(274), 

entry_offset fixed bin 1n1t(275)) internal static; 



/* The following declaration 1s an overlay of the whole stack header. Procedures which 

move the whole stack header should use this overlay. 

*/ 

del stack_header_over1ay (s1ze(stack_header ) ) fixed bin based (sb): 

/* END INCLUDE FILE ... stack_header . Incl .pi 1 */ 
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stpck_seg. incl .pi 1 



segment in: 
entry modi f led : 



>ldd> Include 
10/13/82 1311.9 



contents modified: 10/13/82 1310.8 



/♦ START OF 



stock_seg. incl .pi 1 



del 


stock_segp 


ptr ; 




del 


reeord_stockp 


ptr ; 




del 


vtoce_stockp 


ptr; 




del 


stock_seg$ 


ext ; 




del 


n_in_record_stock 


f Ixed 


bin 


del 


n_vo 1 map_pages 


fixed 


bin 


del 


n_ i n_v toe e_s tock 


fixed 


bin 



♦/ 



del 



1 stock_seg 
2 meters 



aligned based ( stock_segp) . 
aligned like rsmeters. 



2 record_stock_entr tes fixed bin, 
2 vtoce_stock entries fixed bin, 
2 record_stock_s ize fixed bin. 
2 vtoce_stock size fixed bin, 
2 n_stock_entr ies fixed bin, 
2 record_stock_arrayp ptr, 
2 vtoce_stock_arrayp ptr; 



/* Number of entries In a record stock */ 

/* Number of entries in a VTOCE stock +/ 

/+ Size of a record stock in words +/ 

/* Size of a VTOCE stock in words */ 

/+ Number of stocks of each type */ 

/* Record stock region */ 

/♦ VTOCE stock region */ 



del 



record_stock 


al igned based 


( record_stockp) , 




2 


pvtep 


ptr unal , 






/* 


PVTE for this stock */ 




2 


n_1n_stock 


fixed bin 


( 18) 


uns 


unal ,/+ 


Max number of addresses in stock */ 




2 


n_volmap_pages 


f ixed bin 


( 18) 


uns 


unal , /+ 


Number of pages in Volume Map */ * 




2 


n_f ree_ 1 n_s tock 


f ixed bin 


( 18) 


uns 


unal ./* 


Number addresses currently free */ 




2 


n_os_in_stock 


fixed bin 


( 18) 


uns 


unal ./* 


Number addresses currently out -of -serv ice 


*/ 


2 


low_thresholld 


fixed bin 


( 18) 


uns 


unal ./* 


Low threshold for withdrawing from volmap 


*/ 


2 


high__thresho1d 


fixed bin 


(18) 


uns 


una 1 , / * 


High threshold for depositing to volmap */ 




2 


target 


f ixed bin 


( 18) 


uns 


una 1 , / + 


Target for stock */ 




2 


stock_of f set 


bit (18) unal , 




/♦ 


Offset of stock In this structure */ 




2 


n_words_ 1 n_s t ock 


fixed bin 


( 18) 


uns 


unal , /* 


Number of words = Number of entries / 2 */ 




2 


search_ index 


f ixed bin 


(18) 


uns 


unal ,/* 


Roving pointer */ 




2 


old vol map page 


(3) al igned, 




/* 


N_OLD_VOLMAP_PAGES (cif) */ 






3 last 


f Ixed bin 


( 18) 


uns 


unal , /* 


Roving pointer */ 






3 pad 


bit (18) unal , 










2 


volmap_page 


(n_volmap_ 


pages refer ( record_stock . n_vo1map_pages ) ) aligned, 
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3 n_free 
3 baseadd 

2 stock 



fixed bin (18) uns una},/* Number free records In this volmap page */ 
fixed bin (17) unal. /* First record address described by this page */ 

(n_1n_record_stock refer ( record_stock . n_1n_stock ) ) bit (18) unal; /* Stock array of addresses * 

/* bit 0 ON => out-of -service */ 



del 



ndlces */ 



vtoce_stock 

2 pvtep 

2 n__1n_stock 

2 n_f ree_in_stock 

2 target" 

2 search_ Index 

2 stock 



aligned based ( vtoce_stockp) . 

ptr unal, /* PVTE for this stock */ 

fixed bin (18) uns unal,/* Max number Indices in stock */ 
fixed bin (18) uns unal,/* Number indices currently free +/ 
fixed bin (18) uns unal,/* Target when withdrawing/depositing */ 
fixed bin (18) uns unal,/* Roving pointer */ 

(n in vtoce stock refer (vtoce stock. n in stock)) fixed bin (17) unal; /* Stock array of VTOCE 1 



del 



1 rsmeters 



al tgned based, 



2 async_read_ca1 1 s fixed bin (35), 
2 async_page_reads fixed bin (35), 
2 async_post_1o_cal 1 a fixed bin (35), 
2 depos 1 t_cal 1 s fixed bin (35), 

2 async_post_io_t Ime fixed bin (71), 
2 deposit_t1me fixed bin (71). 

2 low_thresh_detected fixed bin (35), 
2 h1gh_thresh_detected fixed bin (35). 
2 low_thresh_fai Is fixed bin (35), 
2 wi thdraw_stock_steps fixed bin (35), 
2 w1thdraw_stock_1osses fixed bin (35), 
2 n_withdraw_at tempt fixed bin (35), 
2 n_wi thdraw_range fixed bin (35). 
2 n_pages_w1 thdraw_stock fixed bin (35), 
2 n_pages_wi thdraw_async fixed bin (35), 
2 n_v_wi t hdr a w_at tempts fixed bin (35). 
2 wi thdraw_volmap_steps fixed bin (35), 
2 depos 1 t_stock_steps fixed bin (35), 
2 depos 1 t_stock_losses fixed bin (35), 
2 n_deposit_at tempt fixed bin (35), 
2 n_pages_depos1t_stock fixed bin (35), 
2 n_pages_depos1 t_volmap fixed bin (35), 
n_v_depos 1 t_at tempts fixed bin (35), 



reset_os_ca1 Is 
reset_os_losses 
withdraw_cal is 
wi thdraw_t ime 
pe depos i t_t Ime 
pc_depos i t_ca 1 1 s 
pc_depos 1 tpages 



fixed bin (35). 
fixed bin (35), 
fixed bin (35), 
fixed bin (71), 
fixed bin (71). 
fixed bin (35). 
fixed bin (35), 



get_f ree_vtoce_ca1 Is fixed bin (35), 
return_f ree_vtoce_cal 1 fixed bin (35), 
2 depos 1t_vstock_cal is fixed bin (35). 
2 depos1t_vstock_fai is fixed bin (35), 
2 withdraw_vstock_ca1 Is fixed bin (35), 



/* Number of asynchronous read attempts */ 

/* Number of times page read was required */ 

/* Number of times read or write posted */ 

/* Number of times deposit called */ * 

/* CPU time posting I/Os (Interrupt side) */ 

/* CPU time In deposit (call side) */ 

/* Number of times stock below low threshold */ 

/* Number of times stock above high threshold */ 

/* Number of times no records in volmap */ 

/* Number steps thru stock in withdraw */ 

/* Number lockless losses */ 

/* Number attempts to withdraw a page */ 

/* Number attempts to withdraw within range */ 

/• Number pages withdrawn from stock */ 

/* Number pages withdrawn from volmap */ 

/* Number attempts to withdraw from volmap */ 

/* Number steps thru volmap in withdraw */ 

/* Number steps thru stock In deposit */ 

/* Number lockless losses */ 

/* Number attempts to deposit a page */ 

/* Number pages deposited to stock */ 

/* Number pages deposited to volmap */ 

/* Number attempts to deposit to volmap */ 

/* Number calls to reset_os */ 

/* Number lockless losses */ 

/* Number calls to withdraw */ 

/* CPU time in withdraw (page-fault) */ 

/* CPU time In pc_deposit */ 

/* Number calls to pc_depos1t */ 

/* Number pages deposited by pc_depos1t */ 

/* Number calls to get_f ree_vtoce */ 

/* Number calls to return_f ree_vtoce */ 

/* Number attempts to deposit to vtoce stock */ 

/* Number times deposit failed */ 

/* Number attempts to withdraw from vtoce stock */ 
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2 withdraw_vstock_fails fixed bin (35). 
2 depos i t_vtoc_map fixed bin (35). 
2 wi thdraw_check_scav fixed bin (35), 
2 wi thdraw_conf 1 ict fixed bin (35). 
2 pad (11) f ixed bin (35) ; 



/* Number times withdraw failed ♦/ 

/♦ Number times vtoce deposited to map */ 

/* Number times withdraw checked an address for scavenge */ 

/+ Number times conflict found */ 



del N_OLD_VOLMAP_PAGES fixed bin Init (3) int static options (constant); 

del DEFAULT_N_IN_RECORO_STOCK fixed bin init (104) int static options (constant); 

del DEFAULT_N_IN_VTQCE_STOCK fixed bin init ( 10) int static options (constant); 

/+ END OF: stockseg. incl .pi 1 ♦*♦♦**♦♦*♦♦♦♦****/ 
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s t r . 1 nc 1 . p 1 1 



segment In: > I dd> t nc 1 ude contents modified: 04/02/70 1914.7 

entry modified: 03/10/82 0836.4 



/* BEGIN INCLUDE FILE ... str.lncl.pll ... 1 

del str__seg$ ext. 
strp ptr; 

del 1 str based (strp) aligned, 

(2 fp bit (18), 
2 bp bit ( 18). 

2 segno bit ( 18) . 
2 dstep bit (18)) unaligned; 

del stra (0:8000) bit (72) based (strp) aligned; 

/* END INCLUDE FILE ... str.lncl.pll */ 



t modified March 1970 */ 

/* segment or process trailer declaration */ 

/♦forward ast trailer rel pointer */ 
/* backward ast trailer rel pointer*/ 

/* segment number*/ 
/* rel pointer to ring 0 dste */ 
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tc_data.cds segment in: > ldd>hard> source system id: 37-15 

contents modified: 01/26/83 1347.1 entry modified: 03/27/83 1807.2 

* Copyright, (C) Honeywell Information Systems Inc.. 1982 * 
+ * 

/* TCDATA - This is the Traffic Controller Database. ♦/ 
/+ Last modified (Date and reason): 

2/6/76 by S. Webber Initial coding 

6/20/79 by Mike Grady to init max_maxe 

3/4/81 by J. Bongiovanni not to set prds_length (It's done from the header 

or the TBLS Config Card) 
3/21/81 by d. Bongiovanni for max_stopped_stack_0, initialization NTO. 

response time metering • 
6/27/81 by J. Bongiovanni for tuning parameter changes (-tcpu. +pre_empt_sample_t ime, 

gp_at_notify and gp_at_pt Inot i f y off by default 
1/82 BIM for stk truncation tuning parras. 
4/27/82 by J. Bongiovanni to change postpurge to OFF 
August 1982, J. Bongiovanni, for rea1time_io parameters 

♦/ 

/* ♦ + ♦♦** + + **** + ♦* + ***♦****♦ + + ****♦♦** + ***■** + ** + * + ***♦ + + * 

* * 

* * 

* Copyright (c) 1972 by Massachusetts Institute of ♦ 

* Technology and Honeywell Information Systems. Inc. * 

* * 

tcdata: proc; 

/* This program creates the tc_data base */ 
/* Automatic */ 

del 1 cdsa aligned like cds_args; 
del code fixed bin (35); 
del bigtime fixed bin (71); 

/+ Based */ 

del 1 tc_data aligned like tern based (temp); 
/* Static */ 

del excludepad (1) char (32) aligned static options (constant) init ("pad*"); 
/* Bui It ins */ 
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del (addr, bin, null, rel , size, string, unspec) bulltln; 
/* Entries */ 

del com_err_ entry options (variable); 

del create_data_segment_ entry (ptr. fixed bin (35)); 

del get_temp_segment_ entry (char (*), ptr, fixed bin (35)); 

del release_temp_segroent_ entry (char (*). ptr, fixed bin (35)); 
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call get_temp_segment_ ( M tc_data". temp, code); 

/* Check offsets assumed by BOS */ 

call check_of f set_f or_bos (addr ( tcdata . aptof f set ) . 171, "aptof f set " ) ; 

call check_of f set_f or_bos (addr ( tc_da ta . apt_s I ze ) . 203, "apt_s1ze"); 

call check_of f set_f or_bos (addr ( tc_data . apt_entry_s ize) , 215, H apt_entry_s Ize" ) ; 



/+ -1 = unlocked ♦/ 
/♦0 s locked ♦ / 



tcdata . apt_of f set = rel (addr ( tcdata . apt ) ) ; 
tc_data . apt_lock ■ -I; 
tc_data. meter 1ng_ lock ■ -1; 
tcdata. work 1ng_set_f actor 3 t; 
tc_data.ncpu ■ 0; 
tc data'. itt_size ■ 155; 
tc_data .dst_s Ize ■ 155; 
tc_data. Initial lzer_id = (36) M 1 M b; 
tc_data.max_el Igible = 6*262144; 
tc_data.max_max_el Iglble ■ 16*262144; 
tc_data.max_stopped_stack_0 = 4; 
tcdata . apt_entry_s ize = size (apte); 
tc_data.pds_length ■ 1024; 

tcdata . interact We_q. fp ■ rel (addr ( tc_data . interact ive_q) ) ; 
tc_data . Interact 1ve_q. bp » rel (addr ( tc_data . interact ive_q) ) ; 
tc_data . interact ive_q. sent inel s (36)"1"b; 



tc_data.max_hproc_segno ■ 191; 
tc_data . dst_ptr ■ null; 
tc_data . old_user » null; 
tcdata. tef irst ■ 2000000; 
tcdata . telast = 2000000; 
tc_data. t imax = 8000000; 

tc_data . process_ini t ial_quantum ■ 2000000; 

tc_data . gp_at_not 1 f y = 0; 

tc_data . gp_at_pt Inot i f y ■ 0; 

tc_data . pre_empt _sampl e_t ime = 40000; 

tc_data . max_t imer register a 4OO00; 



/* largest (default) hardcore segment number */ 



/* off by default */ 
/* off by default */ 
/* 40 milliseconds +/ 



tc_data. sort_to_elhead =1; 
tc_data . auto_tune_ws = 1; 
tcdata . ocore - .01b; 
tcdata . stk_truncate ■ "1"b; 
tc_data. stk_truncate_al ways = "0"b; 

/* See fast_hc_lpc, but the rolling average of steps/block is calculated */ 
/+ as NEW AVERAGE = factor*NEW VALUE + ( 1 - factor ) *0LD AVERAGE */ 



tcdata . stk_trunc_avg_f 1 
tc_data . stk_trunc_avg_f 2 



0.9375; /+ 15/16 +/ 

lb - tc_data . stk_trunc_avg_f 1 ; 



tc_data. lock_error_sever ity = 3; /* BEEP BEEP but no crash */ 
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tc_data.realtime_q.fp ■ rel (addr (tc_data.reall:1roe_q)); 
tc_data. real t ime_q.bp » rel (addr (tc_data.rea1 1:1me_q)); 
tc_data. real t1me_q. sentinel ■ (36)"l M b; 

tc_data.ellglble_q_head.fp ■ rel (addr ( tc_data.el 1gible_q_tall ) ) ; 

tc_data.ellglble_q_head.bp » "0"b; 

tc_data. el lgible_q_head. sentinel ■ (36)"1"b; 

tcdata.el lglble_q_tal 1 . fp ■ rel (addr ( tc_data, ldle_tall ) ) ; 
tc_data.el iglble_q_tal I .bp ■ rel (addr ( tc_data. el igible_q_head) ) ; 
tc_data.el lglble_q_ta1 I . sentinel - (36)"1 H b; 

tc_data. idle_tall . f p ■ M 0"b; 

tc_data. ldle_tal I .bp ■ rel (addr ( tc_data .el lglble_q_ta 11)): 
tc_data. 1d1e_tai 1 .sentinel ■ (36)"l M b; 



tc_data.m1n_el Iglble » 2*262144; 
tcdata . guaranteed_el 1g_1nc ■ 250000; 
tc_data.prlority_sched_1nc ■ 80000000: 
tc_data. 1nt_q_enabled « 1; 
tc_data. f np_buf f er_threshold ■ 30; 



/* fnp tries to keep > this many free buff */ 



OO00000000O00000OOOO 1111111111111111111111111111111111111111111111111111 
bigjtlme; < 

/* gets zeroed by tc_1n1 t$part_2 */ 



unspec (b1g_t1me) ■ 
tc_data.end_of_t Ime 
tc_data.next_alarm_t Ime ■ b1g_tlme; 
tc_data.pr lor 1 ty_sched_t Ime ■ b1g_t1me; 
tc_data. tty_pol lTng_t Ime ■ b1g_t1me; 
tc_data.d1sk_pol 1 1ng_t Ime ■ b1g_t1me; 
tc_data. tape_pol I 1ng_t (me ■ b1g_t1me; 
tc_data. lmp_pol l 1ng_t Ime •» btg_t1me; 
tc_data.mos_pol I 1ng_t Ime ■ b1g_t1me; 
tc_data. volmap__pol 1 1ng_t1me » blg_t1me; 
tcdata . real t 1me_1o_deadl Ine ■ 0; 
tc_data.realt1me_1o_quantum - 5000; 

tc_data .max_channel s ■ 6; 

tc_data. 1n1t_wa1t_t1meout ■ 5000000; 
tc_data. 1n1t_t1meout_sever1ty • O; 
tc_da ta . vcpu_response_bounds_s 1 ze 
tc_data. vcpu_response_bounds (1) a 500000; 
tc_data. vcpuresponsebounds (2) ■ 1000000; 
tc_data. vcpu_response_bounds (3) « 10000000; 



b; 



/* S milliseconds */ 



/♦ 5 second NTO during Initialization 
/* beep 



VCPU_RESP0Nt»E_B0UNDS ; 

/* 1/2 second 



1 second 
10 seconds 



*/ 



tc_data.def aul t_procs_requ1red ■ (8) 
/* Now set up call to create data base */ 



1"b; 



cdsa . sect Ions (1).p * addr (tc_data); 
cdsa . sect 1ons (1).len ■ size (tcdata); 
cdsa. sect Ions (1). struct name ■ N tc data"; 



/+ al I CPUs */ 



cdsa . segname ■ "tc_data"; 
cdsa . num_exc 1 ude_names = 1 ; 
cdsa.exclude_array_ptr ■ addr (exclude_pad) 



Includ' *. hard. source tc_data.cds " i& 1 1 1 

F80A ot to be reproduced 



string ( cdsa . sw Itches ) = "O'b; 
cdsa. switches. have_text ■ M 1"b; 

call create_data_segment_ (addr (cdsa), code); 

call release_temp__segment_ ("tc_data". temp, code); 
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check_of f set_f or_bos : 

proc (1tero_ptr, bos_offset, item_name); 

del ltem_ptr ptr; /* pointer to Item In tc_data */ 

del bos_offset fixed bin (18); /* location assumed by BOS */ 

del 1tem_name char (*); /* name of Item In structure +/ 

If bin (rel (1tem_ptr)) A » bos_offset 

then call com_err_ (0. H tc_data N , ""a not at BOS-assumed offset ("d^oo)". 
1tem_name, bos_offset, bos_offset); 



end check_of f set_f or_bos; 
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% Include cdsargs; 
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% Include apte; 
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% include tern; 

end tc_data; 
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segment in: > 1 dd> 1 nc 1 tide contents modified: 10/27/82 1226.2 

entry modified: 10/27/82 1226.4 



/* BEGIN INCLUDE FILE ... tcm.lncl.pll ... used to generate tc_data cds */ 

/* NOTE -- This Include file has TWO counterparts In ALM: tc_meters. Incl .aim and */ 

/* wcte. incl .aim. They cannot be produced with cif, and must be kept up to date manually. */ 



del temp ptr; 



del 1 tern aligned based (temp), 

2 padbase (3) fixed bin (18), 

2 c1d2 fixed bin ( 18). 

2 c1d3 f txed bin ( 18) . 

2 c1d4 fixed bin ( 18). 

2 depth count fixed bin (18), 

2 loadings fixed bin (18), 

2 blocks fixed bin ( 18), 
2 wakeups fixed bin (18), 
2 waits fixed bin ( 18) , 
2 notifies fixed bin (18). 
2 schedu lings fixed bin (18), 
2 interactions fixed bin (18), 
2 avequeue fixed bin (35, 18), 
2 te_wait fixed bin (18), 

2 te_b1ock fixed bin (18). 

2 te_1_stop fixed bin (18), 

2 te_pre_empt fixed bin (18), 

2 p_1nteract ions fixed bin, 

2 Idle fixed bin (71), 

2 mp_1d1e fixed bin (71), 

2 nmp_1dle fixed bin (71), 
2 zero_1dle fixed bin (71). 
2 last_time fixed bin (71). 
2 looplocks fixed bin (18), 
2 loop_lock_t ime fixed bin (18), 
2 aveel Iglble fixed bin (35, 18) 
2 sort_to_e1head fixed bin (18). 
2 processor_t Ime fixed bin (71), 
2 response_t ime fixed bin (71), 
2 el igib1e_time fixed bin (71), 
2 response_count fixed bin, 
2 el igible_count fixed bin, 
2 quit_counts (0:5) fixed bin. 
2 loading_1dle fixed bin (71). 
2 de1ta_vcpu fixed bin (71). 
2 post_purge_sw1 tch fixed bin. 
2 t ime_out_sever i ty fixed bin. 



/* stat moved from here 



*/ 



/♦ depth last process run ♦/ 

/+ number of process loadings */ 

/+ number of calls to block */ 

/* number of calls to wakeup + / 

/+ number of calls to wait */ 

/* number of calls to notify */ 

/* number of interactive schedulings +/ 

/* recent time average of number in queue */ 

/* times te called from wait */ 

/* times te updated from block +/ 
/* times te updated from 1_stop */ 
/* times te updated from pre_empt */ 

/* times interaction bit turned off because of high priority */ 

/* total Idle time */ 

/* mul t 1 -programming idle */ 

/* non-mul t 1 -programming Idle time */ 

/* zero Idle time */ 

/* last time a process was run */ 

/* times looped on the APT lock */ 

/* time looping on the APT lock */ 

/* average length of eligible queue */ 

/* 0=> no one. 1 ■> Int've only, 2 »> everybody */ 

/* total processor time on system */ 

/* estimate of response time */ 

/+ estimate of eligible time */ 

/* count of response meters */ 

/* count of eligible meters */ 

/* array of buckets indexed by state */ 

/* loadlngidle time +/ 

/* delta virtual CPU time for the system */ 

/* ON if post purging is to be done */ 

/* syserr first arg for notify time outs +/ 
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2 notify_check fixed bin, 

2 qu i t_pr ior 1 ty fixed bin. 

2 iobm_poll ingt ime fixed bin (71). 

2 end_of_time fixed bin (71). 

2 gp_at_notify fixed bin (18). 

2 gpatpt Inot i f y fixed bin (18). 

2 int_q_enabled fixed bin (18). 

2 f npbuf f er_threshold fixed bin (18). 



/* 100 octal +/ 

2 depths (8) fixed bin (18). 
2 tdepths (8) fixed bin (71). 
2 pfdepth (8) fixed bin (18), 

2 pt 1_not_wal ts fixed bin (18), 

2 gw_gp_window_count fixed bin (18), 

2 meter lng_1ock fixed bin (18), 

2 ptlwaits fixed bin (18), 

2 gp_start_count fixed bin (18), 

2 gp_done_count fixed bin (18), 

2 nto_check_t ime fixed bin (71), 

2 nto_de)ta fixed bin (35). 

2 ntocount fixed bin (18). 

2 tcpuschedul ing fixed bin (18). 

2 ntoevent bit (36), 

2 page_not i f ies fixed bin (18). 

2 not 1 f y_nobody_count fixed bin (18), 

2 not 1 fy_nobody_e vent bit (36), 

2 system_type fixed bin. 

2 stat (0:15) fixed bin (18), 

/* 200 octal */ 

2 wait (8), 

3 t ime f ixed bin ( 18) . 
3 count fixed bin (18). 

2 ready (8). 

3 t ime f ixed bin ( 18) , 
3 count fixed bin (18), 

2 total_pf_t1me fixed bin (71). 

2 total_pf_count fixed bin (18), 

2 auto_tune_ws fixed bin (18), 

2 ocore_delta fixed bin (18). 

2 ws_sum fixed bin (18), 

2 nonidle_f orce_count fixed bin (18). 

2 i tt_1 ist_lock bit (36) aligned, 

2 cpu_pf_time fixed bin (71). 

2 cpupf count fixed bin (18), 

2 special_of f sets unaligned, 



/+ obsolete */ 

/♦ factor for scheduler quit response */ 

/+ time to poll iobm */ 

/* very large time +/ 

/* 0 => Just do get_idle_processor */ 

/♦ O => just do get_tdle_processor */ 

/♦ 0 => no intv q in percent mode +/ 

/♦ if fewer free buffs then stingy alloc strategy */ 

/♦ set this to >= half n_t ty 1 ines/f np for safety */ 



/* histogram of run depths */ 

/* histogram of times run per depth */ 

/* histogram of page faults per depth +/ 

/* times pt1_wa it noticed ptl was unlocked */ 

/* times window noticed */ 

/♦ 0 s locked, else unlocked +/ 

/* num calls to ptl_walt */ 

/* to detect gwgp window lossage */ 

/* next time at which nto code will be called */ 

/* microsec between nto checks */ 

/* number of times nto detected */ 

/* obsolete */ 

/* last event which NTO'd */ 



/* used to be tern. inter */ 

/* num apte's in each state */ 



/♦ histogram of page fault waiting times versus did ♦/ 



/* histogram of times in ready queue */ 



/* total time spent from start to end of 

all page faults */ 
/* total number of page faults metered */ 
/* 0=> dont, atherwise compensate for quantum len */ 
/* number of pages reserved for Int users */ 
/* total of el igible's ws_sizes ♦/ 
/♦ count of eligibilities forced */ 
/♦ Lock on ITT free list +/ 

/* total cpu time spent handling page faults */ 
/+ total count of cpu time meterings */ 
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3 apt_of fset bit ( 18), 

3 pad bit ( 18). 
2 getwork_t ime fixed bin (71), 
2 getwork_count fixed bin (18), 
2 short_pf_count fixed bin (18), 
2 interrupt_time fixed bin (71), 
2 interrupt_count fixed bin (71), 
2 ocore fixed bin (35, 18), 
2 pre_empt_f lag bit (36) aligned, 
2 cumulat 1ve_memory_usage fixed binary (71), 
2 processor_t ime_at_def ine_wc fixed bin (71), 
2 boost_pr ior i ty fixed bin, 
2 lost_pr ior ity fixed bin, 
2 tota l_c!ock_1 ag fixed bin (71), 
2 c1ock_s1mulations fixed bin, 
2 max_clock_lag fixed bin, 

/* 300 octal */ 

2 pdscopyl fixed bin (18), 

2 max_hproc_segno fixed bin, 

2 prdsjength fixed bin (18), 

2 pds_length fixed bin (18). 

2 lock fixed bin (18). 

2 id fixed bin ( 18), 

2 system_shutdown fixed bin (18), 

2 work 1ng_set_f actor fixed bin (35, 18), 

2 ncpu fixed bin (18), 

2 last eligible bit (18). 

2 apt_Tock fixed bin (35). 

2 aptsize fixed bin (18). 

2 realtime_q aligned like based_sent Inel , 

2 aht_size fixed bin (18). 

2 itt_slze fixed bin (18). 

2 dst_s1ze fixed bin (18). 

2 itt_free_l ist bit (18), 

2 used_1tt fixed bin (18). 

2 initial 1zer_1d bit (36) aligned. 

2 n_e11gible fixed bin (18), 

2 maX_e11g1b1e fixed bin (30), 

2 waitenable fixed bin (18), 

2 apt_entry_s ize fixed bin (18), 

2 Interact ive_q aligned like based_sent inel , 

2 dst_ptr ptr, 

2 old_user ptr, 

2 initial 1ze_t1rae fixed bin (71). 

2 1nit_event fixed bin (18). 

2 oldt fixed bin (18). 

2 newt fixed bin (18), 

2 tefirst fixed bin (30). 

2 telast fixed bin (30), 



inclyd *. hard. 'source 
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total time spent in getwork */ 

total times through getwork */ 

number of short page faults +/ 

total time spent In Interrupt */ 

total number of metered Interrupts */ 

fraction of core for int've users */ 

controls whether preempting at done time */ 

total number of memory usage units */ 

value of processor_t ime when WC's last defined */ 

number of times priority process given high priority 

number of times priority process lost eligibility */ 

sum of all simulated clock delays */ 

number of times alarm clock interrupt was simulated 

largest simulated alarm clock delay ♦/ 



amount of pds to copy for new process */ 

largest allowed hardcore segment number */ 

length of PROS */ 

length of PDS */ 

process Id generator lock +/ 

next process id to be given out */ 

working set factor */ 

number of processors currently being used */ 

last process to gain eligibility */ 

+ write; 0 hidden; -1 unlocked; -(N+1) Nreaders */ 

number of APT entries */ 

processes with realtime deadlines */ 

APT hash table size */ 

number of ITT entries */ 

number of allowed DST entries */ 

pointer to ITT free list */ 

number of used ITT entries */ 

process id of initializer */ 

number of processes eligible +/ 

maximum allowed number of eligible processes */ 

turned on when waiting mechanism works * / 

size of an APT entry */ 

head of Interactive queue */ 
pointer to device signal table */ 
last process to run (apt ptr ) */ 
time of Initialization */ 

wait event during initialization */ 
timer reading from previous process */ 
timer setting for new process */ 
first eligible time */ 
last eligible time */ 



2 Umax fixed bin (35), 
2 empty_q bit (18), 

2 work 1ng_set_addend fixed bin (18), 

2 ready_q_head bit (0) aligned, 

2 el Igibleqhead aligned like basedsent Inel , 

2 readyqtall bit (O) aligned, 

2 el igible_q_ta i 1 aligned like basedsent i ne I , 

2 idle_tail aligned like based_sent inel , 

2 min_el Igible fixed bin (30). 

2 alarm_t 1mer_1 ist bit (IB) aligned, 

2 guaranteed_el ig_1nc fixed bin (35). 

2 priority_sched_lnc fixed bin (35). 

2 next_alarm_t ime fixed bin (71), 

2 prior 1 ty_sched_t Ime fixed bin (71). 

2 tty_pol 1 ing_t ime fixed bin (71). 

2 disk_pol I ing_time fixed bin (71). 

2 tapepol 1 ing_t ime fixed bin (71), 

2 imppol 1 ing_t ime fixed bin (71). 

2 Imppol 1 ing_lock fixed bin (18). 

2 max_channels fixed bin (18). 

/* 400 octal +/ 

2 system_virtual time fixed bin (71). 

2 creditjaank fixed bin (71), 

2 m1n_wct_ index bit (IB) aligned, 

2 max_wct_index bit (18) aligned, 

2 delta_vt fixed bin (71), 

2 gross_idle_t 1me fixed bin (71), 

2 cred i ts_per_scatter fixed bin (35), 

2 best_credi t_value fixed bin (18), 

2 def ine_wc_t ime fixed bin (71), 

2 max_batch_el ig fixed bin (35), 

2 num_batch_el ig fixed bin (35), 

2 deadl 1ne_mode fixed bin (35), 

2 credi ts_scattered fixed bin (35), 

2 maxmaxel igible fixed bin (30), 

2 max_stopped_stack_0 fixed bin (35), 

2 stopped_stack_0 fixed bin (35), 

2 mospol 1 1ng_ interval fixed bin (35), 

2 mospol 1 1ng_t Ime fixed bin (71), 

2 vcpuresponsebounds ( VCPU_RESP0NSE__B0UNDS ) fixed 

2 vcpu_response_bounds_s ize fixed bin (35). 

2 meter_response_t ime_cal 1 s fixed bin (35). 

2 meter_response_t imeinval id fixed bin (35). 

2 meter_response_t tme_overhead fixed bin (71). 

2 1n1t_wa1t_t1me fixed bin (71). 

2 init_wait_t1meout fixed bin (71). 

2 ini t_t imeout_sever i ty fixed bin. 

2 ini t_t imeout_recurse fixed bin. 

2 max_t 1mer_ register fixed bin (71). 

2 pre_empt_sampl e_t ime fixed bin (35), 

2 govern i ng_cred i t_bank fixed bin (35), 

2 process_1ni t ial_quantum fixed bin (35). 

2 def aul t_procs_requ i red bit (8) aligned, 



/* time in queue for lowest level */ 

/* thread of empty APT entries ♦/ 

/» additive working set parameter */ 

/* for added segdef */ 

/* head of el igible queue ♦/ 

/* for added segdef */ 

/* tail of eligible queue */ 

/* tail of idle list ♦ / 

/* rel pointer to apt entry for next alarm timer */ 

/* amount of guaranteed eligibility time in microsecs. */ 

/* amount of block time before process is given priority +/ 

/+ clock time for next alarm timer +/ 

/♦ time for priority process to be given priority */ 

/♦ time to pol 1 TTY DIM ♦ / 

/* time to poll disk DIM */ 

/* time to poll tape DIM */ 

/♦ time to poll imp */ 

/♦ do not poll if lock set */ * 
/* num special channels per process */ 



/* non-Idle virtual time */ 

/* credits not yet passed out */ 

/* offset of initializer work class table entry */ 

/* offset of highest wcte currently defined */ 

/♦ temp used by pxss.compute_v1rtual_clocks */ 

/* idle t ime_used_clock */ 

/* total number of credits awarded at once */ 

/* temp for pxss . f 1nd_next_el igible */ 

/* clock time when workclasses last degined +/ 



/* 0=> tl sorts, else deadline sorts */ 

/* Maximum of maxe */ 

/* Maximum stack_0's suspended by stopped procs ♦/ 

/♦ Number stack_0's suspended by stopped procs */ 

/* for heals ♦/ 

/* for heals */ 
(35), 



/* used by wait/notify during initialization ♦/ 

/* notify- timeout Interval during initialization */ 

/* not 1 f y- 1 imeout severity during initialization */ 

/* count of NTO recursion during initialization */ 

/♦ max cpu burst = U cpus x pre_empt_sample_t ime */ 

/* tuning parameter - max time between samples */ 

/* used for- limiting eligibility on governed work classes*/ 

/* eligibility quantum first eligibility */ 

/* default mask of CPUs required */ 
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2 work_class_1dle fixed bin (71), 

/ + Tuning Parameters for Stack Truncation * 

2 stk_truncate bit (1) aligned. 
2 s t k_t runca te_a 1 ways bit (1) aligned, 
2 stk_trunc_avg_f 1 fixed bin (35, 18), 
2 stk_trunc_avg_f 2 fixed bin (35, 18). 
2 lock_error_sever 1 ty fixed bin, 

2 gv_ Integration fixed bin (35), 

2 gv_1ntegrat 1on_set bit (1) aligned, 

2 pad8 fixed bin (35), 

2 volmap_pol 1 ing__t ime fixed bin (71), 

2 pad9 fixed bin (71). 

2 realt1rae_1o_pr1or1ty_8w1tch fixed bin 
2 real t 1me_1o_deadl Ine fixed bin (35), 
2 real t 1me_1o_quantum fixed bin (35). 
2 real t1me_pr lor 1 ties fixed bin (35), 
2 relinquishes fixed bin (35), 
2 abort_1ps_mask bit (36) aligned. 

/* 500 octal */ 

2 pad5 (192) fixed bin (35). 
/* 1000 octal */ 

2 pad7 (64) fixed bin (35). 

/* 1100 octal +/ 

2 pad6 (8) fixed bin (35). 
2 work_c1ass_tab1e aligned. 

3 wcte (0:16) aligned like wct_entry, 

/* 3000 octal */ 

2 apt fixed bin; 

del wctep ptr; 

del 1 wct_entry aligned based (wctep), 
2 thread unaligned, 

3 fp bit ( 18), 

3 bp bit (18). 
2 flags unaligned, 

3 mnbz bit (1), 

3 defined bit (1). 

3 1o_pr1or1ty bit (1). 

3 governed bit ( 1 ) , 

3 Interact 1ve_q bit (1), 

3 pad bit (31), 
2 credits fixed bin (35). 
2 minf fixed bin (35). 
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Idle time due to work class restrictions */ 



syserr severity */ 

Integration Interval for governing */ 
ON *> gv_1ntegrat Ion set by ctp */ 



O ■> give I/O Interrupt wakeups realtime prlotlry 

Delta to clock for I/O realtime deadline */ 

Quantum for I/O realtime burst */ 

Count for metering */ 

Calls to rel 1nquish_pr tor ity */ 

IPS mask for tc_ut1 l$check_abort +/ 



room for expansion compatibly */ 



array of per workclass Information */ 



Work class entry */ 
Ready list +/ 
Head of ready list */ 
Tai 1 of ready 11st */ 

Sentinel bit must not be zero. */ 



Current worthiness of group */ 
mln fraction of cpu */ 



2 pinweight fixed bin (35). 

2 eligibilities fixed bin (35), 

2 cpu_sum fixed bin (71), 

2 respl fixed bin (71). 

2 resp2 fixed bin (71), 

2 quantum 1 fixed bin (35), 

2 quantum2 fixed bin (35), 

2 rmeterl fixed bin (71), 

2 rmeter2 fixed bin (71), 

2 rcountl fixed bin (35). 

2 rcount2 fixed bin (35), 

2 realtime fixed bin (35), 

2 purging fixed bin (35), 

2 maxel fixed bin (35), 

2 nel f ixed bin (35) . 

2 number_thinks fixed bin (35). 

2 number_queues fixed bin (35), 

2 total_th1nk_t 1me fixed bin (71). 

2 total_queue_t Ime fixed bin (71), 



/♦ number of cycles to pin pages */ 
/♦ Count of eligibilities awarded */ 
/* CPU used by members */ 



/♦number times process entered "think" state 
/♦number times process entered "queued" state 



/+ The next three arrays correspond to the array vcpu_response_bounds 



*/ 
*/ 



*/ 



2 number_process ing ( VCPU_RESPONSE_BOUNDS+ 1 ) fixed bin (35), /♦ number times entered "processing" state */ 

2 total_processlng_t ime ( VCPU_RESPONSE_BOUNDS+ 1 ) fixed bin (71). 

2 total_vcpu_t ime ( VCPU_RESPONSE_BOUNDS+ 1 ) fixed bin (71). 

2 maxf fixed bin (35). /♦ maximum fraction of cpu time ♦/ 

2 govern ing_credi ts fixed bin (35). /♦ for limiting cpu resources */ 

2 padl (4) fixed bin (35); 



del 1 based_sent inel aligned based. 
2 fp bit (18) unal . 
2 bp bit (18) unal , 
2 sentinel bit (36) aligned; 



/♦ format of pxss-style sentinel */ 



del VCPU_RESPONSE_BOUNDS fixed bin Int.t (3) int static options (constant); 
/♦ END INCLUDE FILE tcm.incl.pll ♦/ 
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vo1_inap. Incl .pi 1 segment In: >ldd>1nclude contents modified: 02/24/76 2027.5 

entry modified: 03/10/82 0836.5 



/* BEGIN INCLUDE FILE ... vol_map. Incl .pi 1 */ 

del vol_mapp ptr; 

del I voljmap based (vol_mapp) aligned, 

2 n_rec fixed b1n(17). 

2 baseadd fixed b1n(17). 

2 n_free_rec fixed b1n(17), 

2 b 1 t_map_n_words fixed b1n(17), 

2 pad (60) b1t(36). 

2 b1t_map (3*1024 - 64) b1t(36) ; 



/* number of records represented In the map */ 

/* record number for first bit 1n bit map */ 

/* number of free records +/ 

/* number of words of the bit map */ 

/* pad to 64 words */ 

/* bit map - the entire vol map occupies 3 records */ 



/* END INCLUDE 



vo1_map */ 



indue* •*, hard. source 
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vtoc_buf far. inc 1 .pi 1 



segment in: > i dd> i nc 1 ude contents modified: 11/19/82 1602.2 

entry modified: 11/19/82 1604.3 



/* START OF: vtoc_buf f er . 1 nc 1 . pi 1 November , 1982 ♦ ***♦*. *»»♦»******/ 



del vtoc_buf f er_seg$ ext; 

del vtoc_buf f er_segp ptr; 

del vtoc_buf_descp ptr; 

del vtoc__bufp ptr; 

del vtoc_buf_desc_arrayp ptr; 

del vtoc_buf _arrayp ptr; 

del vtoc_buf_n_buf f ers fixed bin; 

del vtocjouf _n_buckets fixed bin; 



del 1 vtoc_buffer aligned based ( vtoc_buf f er_segp) . 



2 


lock , 






uiobai lock tor viuo buffers */ 




3 process id 


bit (36) al igned. 


/* 


Owner */ 




3 wait_event 


bit (36) al igned. 




ir Kjt i uck * / • 




3 notify_sw 


bit ( 1 ) al igned, 


/* 


ON => notify on unlock */ 


2 


n_buf s 


fixed bin. 


/* 


Number of full" VTOCE buffers */ 


2 


n_hash_buckets 


f ixed bin, 


/♦ 


Number of hash table buckets */ 


2 


hashjnask 


bit (36) al Igned, 


/* 


Mask for hash algorithm */ 


2 


abs_addr 


f ixed bin (24) . 


/♦ 


Absolute address of vtoc_buf f er_seg */ 


2 


wait event constant fixed bin (36) cms 


una 1 , 


/* Constant to add to part index to form wait event 


2 


bu f _de s c_o f f s e t 


bit ( 18) . 


/* 


Offset of buf_desc */ 


2 


buf_of f set 


bit (18), 


/* 


Offset of buf */ 


2 


hash_tab1e_of f set 


bit ( 18), 


/♦ 


Offset of hashtable */ 


2 


search_ index 


f Ixed bin, 


/* 


Roving pointer for buffer selection */ 


2 


unsaf e_pvtx 


fixed bin. 


/♦ 


IPVTE index with update in progress */ 


2 


scavenger_f ree_p_c 1 ock 










fixed bin (35). 


/* 


Pseudo-Clock for scavenger-free-other-allocate race */ 


2 


meters , 










3 cal l_get 


fixed bin (35). 


/* 


Calls to get_vtoce ♦/ 




3 ca 1 l_put 


fixed bin (35). 


/* 


Calls to put_vtoce */ 




3 cal l_a1 loc 


fixed bin (35). 


/* 


Calls to al loc_and_put_vtoce ♦/ 




3 cal l_f ree 


fixed bin (35), 


/* 


Calls to free_vtoce */ 




3 cal l_awai t 


fixed bin (35), 


/* 


Calls to await_vtoce */ 




3 steps 


fixed bin (35). 


/♦ 


Steps through buffer allocation */ , 




3 skip_os 


fixed bin (35). 


/♦ 


Skipped because out -of -serv ice */ 




3 sklphot 


f ixed bin (35) , 


/* 


Skipped because buffer hot +/ 




3 skip_wait 


fixed bin (35). 


/* 


Skipped because notify_sw set ♦/ 




3 d1sk_reads 


fixed bin (35), 


/* 


Number of same */ 




3 dtsk_writes 


f ixed bin (35) , 


/♦ 


Number of same +/ 




3 get_buf f er_cal 1 s 


f ixed bin (35), 


/♦ 


Number of calls to GET_BUFFER */ 




3 get_buf f er_hi ts 


f ixed bin (35) . 


/* 


Number times VTOCE in buffer */ 




3 wait cal Is 


f ixed bin (35) , 


/* 


Number of cal 1 s to WAIT */ 




3 wait_os 


fixed bin (35) . 


/* 


Number of times had to wait */ 
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e */ 



3 scavenger_f ree_checks 

fixed bin (35). 
3 scavenger_f ree_losses 

fixed bin (35), 



3 pad (15) 
2 hash table 



/* Number of times had to check pseudo-clock */ 

/* Number of times race lost between scavenger freeing and other allocat 
fixed bin (35). 

( vtoc_buf_n_buckets refer (vtoc_bUf fer .n_hash_buckets) ) bit (18) aligned. 



2 buf_desc 
2 buffer 



( vtoc_buf_n_buf f ers refer ( vtoc_buf f er . n_buf s ) ) aligned like vJtoc_buf _desc , 
( vtoc_buf_n_buf f ers refer (vtoc_buf fer .n_buf s) ) aligned like vtoce_buf f er ; 



del 



1 vtoc_buf_desc_array (vtoc_buf fer .n_buf s) aligned based ( vtoc_buf_desc_arrayp) 1 ike vtoc_buf_desc; 



del 



del 
del 



1 vtoc_buf_desc 
2 pvtx 
2 vtocx 
2 parts_used 
2 err 

2 not1fy_sw 
2 write_sw 
2 os 
2 1oq 
2 used 
2 pad 

2 wa1t_1ndex 
2 ht_thread 
2 buf rel 



aligned based (vtoc_tiuf 

fixed bin ( 17) unal . 

fixed bin ( 17) unal . 

bit (3) unal . 

bit ( 1 ) unal . 

bit (1) unal . 

bit (1) unal. 

bit (1) unal . 

bit ( 1 ) unal . 

bit (1) unal , 

bit (9) unal . 

fixed bin ( 17) unal . 

bit ( 18) unal . 

bit (18) unal ; 



descp). 

"/* PVTE Index */ 
/• VTOCE Index */ 
/* Mask of parts used or os */ 
/* ON ■> I/O error on buffer */ 
/* ON »> notify requied on I/O completion +/ 
/* ON -> write I/O *./ 
/* ON ■> I/O in progress */ 
/* ON ■> I/O has been requested */ 
/* ON ■> this descriptor is In use */ 

/+ Buffer Index for forming wait event */ 
/* Offset of next entry in hash table */ 
/♦ Offset of buffer in segment */ ' 



1 vtoce_buf f er_array ( vtoc_buf f er . n_buf s ) aligned based ( vtoc_buf_arrayp) like vtoce_buf fer ; 



1 vtoce_buffer 
2 parts 
3 words 



aligned based (vtoc_bufp), 

(3) al Igned. 

(64) bit (36) al igned; 



del N_PARTS PER_VTOCE 

dc 1 VTOC E_P AR T_S I Z E 

del VTOCE_BUFFER_SIZE 

del N_VTOCE_PER_RECORD 

del N SECTOR PER VTOCE 



fixed bin Int static options (constant) Init (3); 

fixed bin Int static options (constant) init (64); 

fixed bin int static options (constant) Init (3 * 64) 

fixed bin int static options (constant) Init (5); 

fixed bin Int static options (constant) 1n1t (3); 



/* END OF: vtoc_buf f er . 1 nc 1 . pi 1 



*****************/ 



Include +, hard. source 
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vtocheader. Incl .pi 1 



segment In: 
entry modified: 



> ldd> include 
03/10/82 0836. 



contents modified: 05/05/77 0832.2 



/* BEGIN INCLUDE FILE 
del vtoc_headerp ptr; 



vtoc_header. incl .pi 1 */ 



del 1 vtocheader based ( vtocheaderp) aligned, 

2 version fixed bin (.17), 

2 n_vtoce fixed bin (17), 

2 vtoc_last_recno fixed bin (17), 

2 n_free_vtoce fixed bin (17), 

2 f irst_f ree_vtocx fixed bin (17). 

2 pad (3) bit (36), 

2 dmpr_bit_map (2048 - 8) bit (36).; 



/♦ version number. The current version number Is 1 

/♦ number of vtoc entries */ 

/* record number of the last record of the vtoc */ 

/* number of free vtoc entries +/ 

/* Index of the first vtoce in the free list */ 

/♦ space for dmpr bit map + / 



♦/ 



/* END INCLUDE 



vtoc header */ 
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vtoc_map. incl .pi 1 



segment In: > 1 dd> i nc 1 ude contents modified: 05/20/82 1038.4 

entry modified: 05/20/82 1047.7 



/* START OF: 



vtoc_map. Incl .pi 1 



March 1982 



*/ 



del vtocmapp 

dc 1 b 1 t_map_wordp 

del 1 vtoc_map 

2 n_vtoce 
2 n_free_vtoce 
2 b 1 t_map_n_words 
2 vtoc_last_recno 
2 pad 
2 b1t_map 

del 1 bit_map_word 

2 padl 
2 bits 
2 pad2 



ptr; 
ptr; 

aligned based (vtoc_mapp). 



fixed bin. 

fixed bin, 

f txed bin. 

fixed bin. 

(4) fixed bin. 

(0: 1024 - 9) bit (36); 



/* Number of VTOCEs on the device */ 

/+ Number of free VTOCEs */ 

/* Number of words in the bit map below */ 

/+ Last record number in VTOC */ 

/* This structure consumes exactly 1 page +/ 



aligned based ( b 1 t_map_wordp ) , 
bit (1) unal . 

bit (32) una), /* 32 VTOCES ON -> free */ 

bit (3) unal ; 



/* END OF: vtoc_map. Incl .pi 1 *****♦•**♦*•****■♦/ 



includ *, hard. source 
F80f ot to be reproduced 
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vtoce. incl .pi 1 



segment In: > 1 dd> i nc 1 ude contents modified: 11/16/82 1454.7 

entry modified: 11/16/62 1456 ; 6 



/♦ BEGIN INCLUDE FILE ... vtoce. Incl .pi 1 ... last mod 

/* Template for a VTOC entry. Length ■ 192 words. (3 +64). 
del vtocep ptr; 

del 1 vtoce based (vtocep) aligned, 



(2 pad_f ree_vtoce_chain bit (36), 

2 uid bit (36), 

2 msl bit (9), 
2 csl bit (9), 
2 records bit (9), 
2 pad2 bit (9), 

2 dtu bit (36), 

2 dtm bit (36), 

2 nqsw bit ( 1 ) , 

2 dec iduous bit ( 1 ) , 

2 n i d bit ( 1 ) , 

2 dnzp bit (1). 

2 gtpd bit ( 1 ) . 

2 per_process bit (1), 

2 damaged bit ( 1 ) , 

2 fmdamaged bit (1), 

2 f m_checksum_val id bit (1), 

2 synchronized bit (1). 

2 pad3 bit (8) . 

2 dirsw bit ( 1 ) , 

2 master_dir bit ( 1 ) . 

2 pad4 bit (16)) unaligned, 

2 fmchecksum bit (36) aligned, 

(2 quota (0:1) fixed bin (18) unsigned. 

2 used (0:1) fixed bin (18) unsigned. 

2 received (0:1) fixed bin (18) unsigned. 

2 trp (0: 1 ) f ixed bin (71 ) . 

2 trp_t ime (0:1) bit ( 36 ) . 



f led September 1982 */ 
♦/ 



/* Used to be pointer to next free VTOCE */ 

/* segment's uid - zero if vtoce is free */ 

/+ maximum segment length In 1024 word units */ 

/♦ current segment length - in 1024 word units */ 

/* number of records used by the seg in second storage */ 



/+ date and time segment was last used */ 

/* date and time segment was last modified */ 

/+ no quota switch - no checking for pages of this seg */ 

/* true if hc_sdw */ 

/+ no incremental dump switch +/ 

/* Oont nul I zero pages */ 

/* Global transparent paging device */ 

/* Per process segment (deleted every bootload) */ 

/* TRUE If contents damaged */ 

/* TRUE If filemap checksum bad ♦/ 

/* TRUE If the checksum has been computed */ 

/* TRUE .if this is a data management synchronized segment */ 

/* directory switch +/ 

/♦ master directory - a root for the logical volume */ 

/* not used */ 

/* Checksum of used portion of file map +/ 

/* sec storage quota - (0) for non dir pages */ 

/* sec storage used - (0) for non dir pages */ 

/* total amount of storage this dir has received */ 

/ + time record product - (0) for non dir pages */ 

/* time t irae_record_jproduct was last calculated */ 



include.**, hard. source 
F80A - Not to be reproduced 



vtoce. incl .pi I 
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2 fm (0:255) bit (18). /+ 

2 pad6 (10) bit (36). /* 

2 ncd bit ( 1). /* 
2 pad7 bit (17). 
2 pads bit (18). 

2 dtd bit (36). /+ 

2 vol Id (3) bit (36). /* 

2 master_d1r_u1d bit (36). /* 

2 uid_path (0:15) bit (36). /* 

2 pr troary_nama char (32), /* 

2 time_created bit (36). /* 

2 par_pv1d bit (36). /* 

2 par_vtocx fixed bin (17), /* 

2 branchrp bit (18)) unaligned, /* 

2 cn_sa1v_time bit (36), /* 

2 access_c1as8 bit (72), /* 
2 permf lags aligned, 

3 perbootload bit (1) unal , /* 

3 pad9 bit (35) unal, 

2 owner bit (36); /* 

del vtoce_parts (3) bit (36 * 64) aligned based (vtocep); 

del 1 segvtoce based (vtocep) aligned. /+ 
2 padl bit (7*36). 

2 usage fixed bin (35), /* 
2 pad2 bit ( 184*36) ; 

/* END INCLUDE FILE vtoce.incl.p11 */ 



file map - 256 entries - 18 bits per entry */ 
not used */ 

no complete dump switch */ 
date- t I me -dumped */ 

volume ids of last incremental, consolidated, and complete dumps */ 
superior master directory uid */ 

uid pathname of all parents starting after the root */ 

primary name of the segment */ 

time the segment was created */ 

physical volume id of the parent */ 

vtbc entry index of the parent */ 

rel pointer of the branch of this segment */ 

time branch - vtoce connection checked */ 

access class in branch */ 

ON n > deleted each boot load */ 

pvld of this volume */ 

Overlay for vtoce of segments, which don't have quota */ 
page fault count: overlays quota */ 



Includr *, hard. source 
F80A ot to be reproduced 



vtoce. incl .pi 1 
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Figure 0-2 . Page Control Data Bases 
Page in main memory,* not on paging device 
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Figure 6-1. Page Control Data Bases 
Page not in main memory or on paging device 
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COMMON MULTICS PERFORMANCE PROBLEMS 



System Tasks Takij igiJI^Qj^cjl_ ? esourc g s 



MTAR 

Too much backup during prime time 

Directory salvaging after ESDless crash 

System personnel favored by workclass parameters 

Parameters 5>«~t 

Work Class Parameters 

Absentees in separate workclass e<£\s uQ T\v-«. 

Traffic Control Parameters "F£-£^s — -roc A ? 

telast too high 

maxe wrong, usually too low 



AST Size 

Segment thrashing due to small pool size(s) 

Hardware Configuration 

Not enough memory 
Not enough disk channels 
Not enough logical channels 
Not enough disk arms 
Insufficient CPU power 

n-5 eV t /r\ 



Unbalanced disk I/O 
C^mmur^cajbi.ons 

HASP lines _ / A _ T 

X.25 lines c fi" s ? ^l^t^pts^ r*^ c/i f u ^ 
breakall on dialout lines 



Bootload console looping 
Initializer time at maxu users 
Application causing segment thrashing 
Application using too much CPU time 

Bad write/notify cables ^ k&lcvc r 0 , A ^ < 
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